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Warranty Statement 

Hewlett-Packard products are warranted against defects in 
materials and workmanship. For Hewlett-Packard Desktop 
Computer Division products sold in the U.S.A. and Canada, this 
warranty applies for ninety (90) days from date of delivery.* 
Hewlett-Packard will, at its option, repair or replace equipment 
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warranty includes labor, parts, and surface travel costs, if any. 
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shipped freight prepaid. Repairs necessitated by misuse of the 
equipment, or by hardware, software, or interfacing not provided 
by Hewlett-Packard are not covered by this warranty. 

NO OTHER WARRANTY IS EXPRESSED OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE. HEWLETT-PACKARD SHALL NOT BE LIABLE FOR 
CONSEQUENTIAL DAMAGES. 

*For other countries, contact your local Sales and Service Office 
to determine warranty terms. 
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Chapter X 

General Information 



Welcome to the world of assembly language programming on the System 45^ 

It is the design of the Assembly Execution and Development Read Only Memory (ROM) and 
the Assembly Execution ROM to help extend the capabilities of your 9845 by giving you greater 
control and speed through the use of machine instructions, pseudo-instructions, and exten- 
sions to the BASIC language. 

The assembly language system is provided to you as one of two ROMs which plug into the right 
ROM drawer of your System 45. The two ROMs are: 

• The Assembly Execution and Development ROM - used to write and debug assem.bly 
language programs on the System 45, and has the complete capability of the Assembly 
Execution ROM. 

• The Assembly Execution ROM - provides the capability to load, run, and store assem- 
bled routines and modules. Information about this ROM can be found in the Assembly 
Execution ROM manual. 



When installed, the Assembly Execution and Development ROM reserves some read /write 
memory which cannot be accessed for storage of programs or data. (The Assembly Execution 
ROM also reserves memory.) The following table describes the actual read /write memory used 
(in 8-bit bytes) under various configurations: 



Executi 


on ROM Only 


Execution and Development ROM 


I/O ROM Present 


I/O ROM Not Present 


I/O ROM Present I/O ROM Not Present 


Power on 270 


334 


590 


654 


After 








first 708 


772 


1028 


1092 


pre-run 









It is assumed throughout this manual that you are familiar with the basic operation and lan- 
guage of the 9845. It is also assumed that you are reasonably well-acquainted with at least one 
other assembly language. 

1 The assembly language programming capability is not available for the System 45A computer. 
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Equipment Supplied 

The following items are supplied with the Assembly Execution and Development ROM - 



Item 


Part Number 


Assembly Development ROM Manual 


09845-91083 


Assembly Execution ROM Manual 


09845-91082 


Assembly Language Quick Reference 


09845-91080 


BASIC Language Interfacing Concepts 


09835-90600 


Demonstration Cartridge 


11141-10155 


Error Label 


7120-8771 



Structure of the Manual 

It is the intent of this manual that you should be able to find between its covers everything you 
need to know to use the assembly language effectively. However, since assembly language 
programming is a complex topic, the manual relies a great deal on your past experience. Most 
of the information is in succinct presentations of a particular topic; it is not the intent to "teach" 
assembly language programming to someone not familiar with the topic. 

The major topics covered are: assembly language program creation, the processor and relevant 
operating system constructs, assembly language fundamentals, BCD and integer arithmetic, 
communications with BASIC, I/O handling, debugging tools, errors and error processing, and 
graphics. Each topic (chapter), has a summary at the beginning detailing the information to be 
presented therein. 

The manual is organized so that each topic can be covered completely within a given chapter. 
This approach was chosen over the strict syntactical or semantical treatment of the individual 
statements and instructions. As a consequence, you may find this difficult to use as a "quick 
reference" for syntax and meaning of the individual commands. 

To meet your needs for "quick reference" material, an Assembly Language Quick Reference 
Manual (HP part number 09845-91080) is provided. In addition, you will find much of the 
information in this manual condensed and tabulated in the various appendices of this manual. 

A recommended method for using the manuals is to start with this one as your basic learning 
tool. Then you should be able to use the Quick Reference Manual effectively for all future 
reference. 
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Purpose of the ROMs 



The Assembly Execution and Development ROM is used to write and debug assembly language 
programs on the System 45, and also has the complete capability of the Assembly Execution 
ROM. The Assembly Execution ROM provides the capability to load, run, and store assembled 
routines and modules. 

The Assembly Execution ROM is used independently of the Assembly Execution and De- 
velopment ROM. Because of the overhead required by the debugging features of the Assembly 
Execution and Development ROM, programs run slightly more rapidly if the Assembly Execu- 
tion ROM is used rather than the Assembly Execution and Development ROM. 



ROM Installation 

Before assembly language programming can proceed, the ROMs must be in place. The installa- 
tion is a simple process. 

There are two ROM drawers for the computer: one on the right side of the machine one on the 
left. The ROM is installed in the right ROM drawer, using these steps: 

• Pull the right ROM drawer out. 

• Squeeze the sides of the plastic cover and lift to gain access to the drawer connectors. 

• Position the ROM over one of the connectors denoted by a O or D marking. 

• Press the ROM onto the ROM drawer connector so that it seats all the way down. The 
small circular keys on the sides of the ROM drawer should fit into the recesses in the 
bottom of the plastic ROM case. If they don't, make sure that you have properly oriented 
the ROM. 
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Assembly Language System ROM 

After inserting the ROM, close the drawer until it is flush with the outside cover of the machine. 
With this done, you are now ready to begin writing assembly language programs. 




Figure 1. Installing the Assembly Execution and Development ROM 
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Buzzwords 

During the course of the discussions in this manual, words and phrases are used which are in 
common circulation among those who are familiar with assembly languages. While the mean- 
ings of most are either well-known, or are deducible from the context, there are a few which 
may be unfamiliar, or unique to the 9845 assembly language, or are variable from one assem- 
bly language to the next and thus need to be defined for this one. They are — 

assembled location — a reference to a location in memory which may be specified in one 
of the following forms — 

{symbol} [ , {numeric expression} ] 
{expression} [ , {numeric expression} ] 

where: 

{symbol} is an assembly location. It may be a label for a particular machine instruction (in 
which case the address of the associated instruction is used), or an assembler-defined 
symbol (in which case the associated absolute address is used), or a symbol defined by an 
EQu instruction (described in the "Symbolic Operations" section of Chapter 4). 

{expression} may be a numeric expression or a string expression. If numeric, a decimal 
calculation is performed and the result is interpreted as an octal value; if the result is not 
an octal representation of an integer, an error results. If a string expression is used, the 
string must be interpretable as either an octal integer constant or a known assembly 
symbol (see {symbol} above). 

{numeric expression} serves as a decimal offset from the given label or constant. 

busy bits — each variable located in the BASIC value or common areas has associated 
with it two bits: a "read" busy bit, and a "write" busy bit. When a "read" busy bit is set, 
attempts should not be made to perform a function on that variable. A read operation may 
be performed on a "write-busy" variable. When the busy bit is cleared, the function may 
be performed on the variable. 

byte — a group of 8 binary digits (bits). 

coRditionai assembly — an assignation that certain portions of a module are not to be 
assembled unless a condition has been set. The portions begin with any of the IFA through 
IFH, and IFP, pseudo-instructions, and end with the next XIF pseudo-instruction. IFA 
uses the A-condition as a test, and so on. The conditions are set by the statement assem- 
bling the module (lASSEMBLE). 
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interrupt service routine (ISR) — an assembly language routine intended to perform a 
certain action, or set of actions, when the computer receives a request from an external 
device. An "active" ISR is one which is currently enabled for a given device. 

mass storage unit specifier (msus) — a single word corresponding to the BASIC lan- 
guage mass storage unit specifier as described in either the 9845 Operating and Pro- 
gramming Manual or the Mass Storage Techniques Manual. An msus has one of the 
following structures — 



Unit 
Number^ 


HPIB 
Address 


Device 
Type^ 


Select 
Code 


1 1 1 
1 1 1 


1 1 
1 1 


1 1 1 1 
1 1 1 1 


1 1 1 
1 1 1 



1514131211 10 9 8 7 6 5 4 3 2 1 OBIt 



or 





Unit 
Number 


Device 
Type^ 


Select 
Code 


1 1 1 

1 1 1 


1 1 
1 1 


1 1 1 1 
1 1 1 1 


1 1 1 
1 1 1 



1514131211 10 9 8 7 6 5 4 3 2 1 OBIt 
for the 9885MS Flexible Disk Drive 

An msus can designate the current default as its mass storage device (meaning it will use 
the device indicated by the last MASS STORAGE IS statement executed). This is desig- 
nated by having the msus be all ones (i.e., equal to - 1). 

object module — a section of assembled code stored in the particular region of memory 
set aside for it. Though the source module for the object code may no longer be resident in 
memory, when created, the module was delimited by certain pseudo-instructions (NAM 
and END) and is referenced by the name given to it by the NAM pseudo-instruction. 



octal expression — a numeric expression which, when displayed or printed, appears as 
an octal (base-8) number. Within arithmetic operations, it has a decimal value (base-10). 
Thus, the value 178 will appear as 17 (representing the value 15io), but if arithmetic was 
performed on it, it would act as if it were 17io. All octal expressions are necessarily 
integers in the range of to 1777778. 

1 The cievice type is the ASCII code for the type minus lOOB. 

2 For tape operations, bits 9-15 are zeros. 
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pixel — picture element — the smallest unit of resolution on the CRT. 

source module — a section of assembly language source code beginning with a NAM 
pseudo-instruction and ending with the END pseudo-instruction. 

word — two bytes; a group of 16 binary digits (bits). 

B — octal radix specifier. For example 177777B is 177777 octal. If the trailing "B" is not 
present, the assembler assumes decimal. 

• — shorthand for current location. For example, 



is equivalent to — 



Fundamental Syntax 



The syntax conventions used in this manual are those used in the Operating and Programming 
Manual for the 9845. 



All syntax items displayed in dot matrix form should be pro- 
grammed as shown. 



[ ] Items contained in brackets are optional items. 

Ellipses mean that the previous item may be repeated 
indefinitely. 

In addition, the following convention is employed throughout the Assembly Language series of 
manuals — 

{ } Items contained in braces are syntax items considered as a 
unit. The names inside are usually descriptive of the function 
intended for that item. Whenever an item enclosed in braces 
appears in the text, the notation refers to the same notation 
within an earlier syntax. 
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Chapter mL 

Getting Started 



Summary: This chapter contains a general discussion of the assembly language sys- 
tem. A format for the creation of an assembly language program is presented. Topics 
such as modules, routines, and memory allocation are discussed, along with methods of 
using them effectively. Also discussed is the storage and retrieval of modules on mass 



The thing to remember about the assembly language system is that it has been thoroughly 
integrated into the operating system of the System 45. Once the ROMs have been installed, you 
are able immediately to begin programming in assembly language. In addition, you have the 
capability to load and store your programs on mass storage, to assemble them separately or 
leave them in source form, to execute them from BASIC and pass BASIC variables to them, 
and to debug them, including a full pausing and stepping capability. 



Developing Routines for Later Use 

Most assembly language programs are written with the intent that they will be used many times, 
not just at the time they are written. It is for just such program development that the full 
capabilities of the assembly language system come into play. The development comes in 
several stages. Each stage has its unique requirements and the tools to meet those require- 
ments. 

The first stage is creation of the source program. This is achieved by the use of the editing 
capabilities of the System 45. Additionally, the mass storage capabilities of the computer can be 
used. 

The second stage is the creation of the object (or machine) code. This requires not only an 
assembly of the source, but the ability to allocate special locations in memory to hold the newly 
created object code. 

The third stage is the validation of the routines as written, commonly known as "debugging". 
This is enabled by calls from a BASIC driver, followed by application of various debugging 
tools provided by the assembly system. The capabilities to pause and step a program, have been 
extended to assembly language instructions to assist this process. 
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The fourth stage is to store away the debugged object code so that it may be used at a later 
time. A special mass storage statement is provided by the assembly language system. This 
statement stores object code into a special assembly file. 

Finally, the end-user of the routines must be able to retrieve the object code from mass storage 
as it is needed. He also must be able to access the routines from BASIC programs. Both these 
needs are met with the Execution ROM, so the capabilities are not only provided, but they are 
provided independently of the program development capabilities located in the Assembly 
Execution and Development ROM. 

Each of the topics involved in these stages is discussed at length in this manual. 

Figure 2 presents a graphical presentation of this overview. 





Mass Storage Editing 
Capabilities Source Capabilities 
, , of System 45 , , Statements , , of System 45 




(Source) Program Creation 
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Assembly 
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^ 


Calls from 
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Assembly Language System's 


Lili£j 
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Debugging Tools 
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Storage 
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r 








User's BASIC Programs 
(includes calls to routines) 





Figure 2. Overview of Assembly Language Routine Development Process 
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Overview 



At this point, there are three fundamental structures to be explained: programs, modules, and 
routines. 

A program is the set of source statements from which the object (or machine) code is gener- 
ated. The assembly source statements are extensions to the BASIC language which is used in 
the System 45. The statements themselves are stored in the machine as part of the BASIC 
program in which they reside. At some point, you must take the assembly source statements 
and assemble them into object code, in order for them to be run. The object code is stored in a 
S'^ecified location in the m.achine. 

A module is a subset of the object code. It is a means of separating and identifying parts of the 
code so that those parts may be used individually (as in mass storage operations). There may 
be any number of modules present at any one time, limited only by the amount of memory 
allocated for object code. 

A routine is a "callable" section of a module. It is analogous to the subprogram in BASIC. It 
has a named entry point, possibly a parameter list, and a return. A module may contain any 
number of routines, again limited only by the amount of memory allocated to hold the object 
code. 

In short, the usefulness of each structure is as follows — 

• Programs contain assembly language source code. 

• Modules contain object code to be loaded from or stored on mass storage. 

• Routines are executable sections of object code. 

Program Creation 

The first matter which is likely to concern you about the assembly language system is how to 
create an assembly language program. 

In general, the process of creating an assembly language subprogram consists of the following 
steps — 

1. Enter and store the source code (program). 

2. Create an area in memory which will ultimately contain the object code. 

3. Assem.ble the source code into object code, storing the latter into the area of m^emory set 
aside for it. 

4. Execute the object code (routines) from BASIC "drivers". 
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Each of these steps will be discussed at length in the pages of this manual, along with a number 
of not-so-incidental side-topics (such as "debugging" techniques). The purpose of this short 
section is to give you an impression of the general procedure through which an assembly 
language subprogram is created. 

As an example to use to demonstrate the process, suppose the following task has been assigned 
to you — 

Requirement: Write an assembly language subprogram which takes two integer 
values and multiplies them together as integers. If the result overflows the range of 
an integer (- 32 768 to + 32 767), then the subprogram should return the same 
error as the system would (i.e., error number 20). 

With this task in hand, suppose that you have completed a programming analysis that suggests 
that the following assembly language source code would fulfill the subprogram's functions — ^ 



10 


loUURut 






20 


I SOURCE 






30 


I-z-OUkCE 


Ii- 


M-eger 


40 


I SOURCE 






50 


X -Z" L^' J K U b. 


Ir 


iput. 1 : 


gfi 


I SOURCE 


If 


iput2: 


70 


I SOURCE 


fu 


nput : 


80 


I SOURCE 


Mi 


4 1 t. 1 p ] 


90 


I SOURCE 






100 


I SOURCE 






I ly 


I SOURCE 






Idk} 


I SOURCE 






130 


I SOURCE 






140 


I SOURCE 






150 


I SOURCE 






160 


i bUUKL'b 






170 


I SOURCE 






180 


I SOURCE 






180 


I SOURCE 






200 


I SOURCE 






ii! i y 


i bUUKUb 






2:20 


I SOURCE 






230 


I SOURCE 






240 


I SOURCE 






250 


I SOURCE 






260 


I SOURCE 







HflH Mul 



INT 



Eeqi 



iq of rnodu 



■ or-a.Qe arsa for integers created 
idicates en try point follows 
'idicates "integer par-ameters are 
passed in the order qi '.-ien by tht 
stat-ernent-s and -are qi '-.-'en rt-arr^es 
ua i 



' Hrtual entry point (name: Multiply); 
routine- begins by fetching actual 
value of the input parameters 






LDE =inputl 

LDE integers+1 ! an thmet i c accufnu lator and 

MrY \ finally multiplies them 

SEP *+2 ■ fl check for overflow is performed 

ind the routine is aborted 

imonq the arguments 



DH =20 


1 


t;n Error exit 


1 


TH Integers 


i T 


DH = Integers 


I T 


EB =Output 


! 


5M Put__value 


! 


ET 1 


■ H 


SB Multipl ■icafic 


n \ 



1 The fact that it is rarely possible to create a running program at this stage should not get in the way of accepting the example. 
Usually there is debugging involved in later stages. 
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machine as a program. This is done by preceding each and every assembly language statement 
with the keyword ISOURCE and entering it as a program line. The process of entering (with the 
keyword included) is the same as with any other BASIC statement — so you can use EDIT or 
AUTO and the (^™^ key in the same way you normally enter any BASIC statement. (This 
process is fully described in the "Program Entry" section of this chapter.) 

The final result of entering the routine would look something like — 



r-im r-sn 















This source code demonstrates the three critical items in assembly subprograms. First, a routine 
has to be part of a module; modules are delimited with the NAM and END pseudo-instructions 
(see lines 10 and 270 in the source). Second, a routine has to have an entry point; this consists 
of a SUB pseudo-instruction (see line 40), any parameters (see lines 50 through 70), and a 
name (the label used on the first machine instruction following the SUB, see line 80). Finally, a 
routine must be able to return to the BASIC program which called it; this is accomplished with 
the RET 1 instruction (see line 260). 

The NAM, END, and SUB pseudo-instructions are discussed in Chapter 4. The RET 1 instruc- 
tion is discussed in Chapter 3. 
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The next three steps in program creation are each satisfied with BASIC-executable statements. 
Creation of a storage area for the object code for the program (which can be estimated at less 
than 40 words; there is essentially one word of object code per line of source) is accomplished 
by programming the staterhent — 

2S0 I COM 40 

(The ICOM statement is fully discussed in the "Setting Aside Memory" section of this chapter. ) 

This can be followed in the same program by an instruction to assemble the source code into 
object code — 

290 I flSSEMELE Mu i 1 1 p I i cat. i on 

(The lASSEMBLE statement is fully discussed in Chapter 4.) 

If the assembly is successful (and it will be in this example), then the routine can be called and 
used as desired. A typical call looks like — 

600 IChLL Mul t i pi y ( I ndex, D i mens i on, Subsc r ^ pt > 
610 flrray: Subsc r i pt ■'='v'al ue 

(The ICALL statement is fully discussed in Chapter 6.) 



Thus, the final result could easily be — 



10 


I SOURCE 






HRM 


Mul 1 1 pi icat- -! on 


! Eeqmning of module 


20 


I SOURCE 






EKT 


Error-_exit.,Get._ 


value, Put value ! Ut i 1 i t 1 es 


30 


I SOURCE 


Tj- 


it.i=Q6'rS 


: ESS 


2 r 


Storage area for integers crea 


40 


I SOURCE 






SUE 


! 


Indicates entry point follows 


50 


I SOURCE 


T|- 


-iput. 1 : 


I NT 


1 




60 


i -I'U'JKUc 


i r 


"ipijt 2 1 


I NT 


! 


passed in the order gi uen by 


70 


I SOURCE 


Ol 


jtput : 


I HI 




staternents and are gi ven nam 


80 


I SOURCE 


I'M 


4]t.iply 


: Llifl 


= Integers ! 


Actual entry point (nar^e: Mult 


90 


I SOURCE 






LDB 


= Input! ! 


routine begins by fetching a 


100 


I SOURCE 






JSM 


Get^value i 


value of the input parameter 


110 


I SOURCE 






LDH 


=Inteqers+l ! 


from BASIC and storing them 


120 


I SOURCE 






LDE 


= Input 2 ! 


the routine can use them 


140 


ISOURCE 






■JSM 
LDfl 


Get.__yalue 
Integers i 


Then it h:>ads the values into 


150 


ISOURCE 






LDE 


IntegersH-l ! 


ar- 1 1 hmet i c ac c umiu 1 at or and 


lb0 


ISOURCE 






MP'-,-' 




f 1 na 1 1 ;,■■ i-M u 1 1 i p 1 i e s % h e u\ 


1 7|.7i 


ISOURCE 






SEP 


*+2 ! 


H check for over flow is per for 


180 


ISOURCE 






CME 




by checking the f-esult for a 


190 


ISOURCE 






SZE 


•s-f3 ! 


in the E register when it sh 


200 


ISOURCE 






LDR 


=^20 ! 


and if it isp-'t. Error 20 is 


210 


ISOURCE 






JSM 


Error e >d t : 


and the routine is aborted 


220 


ISOURCE 






Sin 


Integers ^ 


If ^.,..,e|.-.,it.i.-,ir.q is uK, then resu 
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It isn't necessary that a program be assembled in every BASIC program which uses it. Object 
code can be stored on mass storage with a statement like — 



So if the example were instead made to read — 



Integers 


1 


:tual 


- 1. ■■..■.5. 1 U ^' 




■•.■■•5.1 ue 


Integer s-^1 




from 


Input? 




the r 


et value 






-:t.egers 


"" 


-len It 


ntegers+1 




antr 



■qis- 






jnq 
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the object code is consequently stored into the file "MULT". 

Later programs can retrieve the object code for use, such as in the following program — 

1 I NTEGER D i mens i on , I ndex , Subs-c r i fA- 

20 i COM 40 

30 I LOAD ^'MULT^^ 



600 IChLL Mul tip] v"'- Index, liiniens ion, Subscr ip' 
b 10 Hrray <Subsc r i pt >=-'/a1 ue 



(Both ISTORE and ILOAD are discussed in the "Retrieving and Storing Modules" section of 
this chapter.) 

Program Entry 

The assembly language source statement is an extension to the BASIC language used in the 
System 45. This means that each assembly language statement is entered using a 
"keyword" — in this case ISOURCE — as a message to the operating system that the line is an 
assembly language statement. 

By looking at an example, you can see what is meant — 



10 


LET R=ie 


1 








20 


LET B=2e 










30 


PRINT R, 


E 








40 


ISOURCE 




Nflil 


hxamp 


1 e 


■J '-' 


ISOURCE 




NOP 






60 


ISOURCE 




EHD 


Examp 


1 e 


70 


END 











Lines 10, 20, 30, and 70, are all recognizable as BASIC statements. The keywords they 
use — LET, PRINT, and END — direct that certain actions take place. Lines 40, 50, and 60, 
are all assembly language statements; this was indicated by the ISOURCE keyword used in 
these lines. 

Entering assembly language statements, by using the ISOURCE keyword, is thereby the same 
process as entering other types of BASIC statements. You may use all of the system editing 
features that you are used to using in the creation of BASIC programs — EDIT, AUTO, etc. You 
store each line with the (^^ key, as you would any other BASIC line. See Appendix I for Demo 
Tape Special Function Keys which are useful for program entry. 
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Also, assembly lines do not have to be in any special place in the BASIC program. The previous 
example could be re-arranged as follows — 



LET H=1S 






I SOURCE 


NfiM E 


■v3.rnj: 


LET 2=20 






I SOURCE 


NOP 




PRINT n,E 






I SOURCE 


END E: 


amp 



ENTI 



Thus, you are free to enter your assembly statements anywhere in your BASIC program. But, 
you may ask, what is the effect of spreading them out like this? The answer is, simply, none. 
When the time comes to use them, assembly statements and BASIC statements are separated 
by the operating system and treated differently. 

When the BASIC program is run, only the BASIC statements are executed. The ISOURCE 
statements are ignored, and, as you will be shown in Chapter 4, when the assembly language 
lines are assembled, the BASIC statements are ignored. A way to consider it is that there are 
two programs in one — BASIC'S and the assembler's. So you can envision the example above 
as being this way — 



BASIC ASSEMBLER 



^ source y 



You should note, then, that ISOURCE statements are not "executable" in the usual BASIC 
sense. Their location in the program does not indicate the place where they will be executed. 
Assembly instructions are not executed until a routine is "called"; this is discussed in detail in 
Chapter 4. 

Now that it has been said that the two types of statements can be thoroughly intermixed, it 
should also be said that the practice is not recommended. As a good programming practice — 
i.e., for readability and to preserve the self-documenting features of BASIC — it is recom- 
mended that assembly statements be collected together and placed in one spot in the program. 

The first example is a recommended practice over the second, even though the second is 
permissible. 
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Other Extensions 

In addition to the ISOURCE statement, there are a number of other BASIC language exten- 
sions provided by the assembly languge system. Unlike the ISOURCE statement, they are 
"executable", and their appearances are part of the BASIC lines (as distinguished from the 
assembler's). Where they appear is where the action associated with them is taken. This is 
identical to the way the other BASIC statements perform. The statements involved are — 

lASSEMBLE 

IBREAK 

ICALL 

ICHANGE 

ICOM 

IDELETE 

IDUMP 

ILOAD 

INORMAL 

IPAUSE OFF 

IPAUSE ON 

ISTORE 

OFF INT 

ON INT 

Also provided are four numeric functions — 

DECIMAL 
lADR 
IMEM 
OCTAL 



The functions can be used wherever numeric functions in general may be used. 

All of these statements (except ICOM and ISOURCE) and the functions are available to you as 
live keyboard operations as well as programmable statements. A full discussion of each of the 
statements and functions can be found within this manual. 



Getting Started 2-11 



Modules and Routines 

There are three basic activities associated with using assembled modules and routines. First, 
there is the need to retrieve them from wherever they may be stored (including providing a 
place for them to be kept while they are resident in the memory of the machine). Second, there 
is the actual execution of the routines. And third, there is the occasional requirement to store, 
or re-store a module on mass storage (including, perhaps, the need to free the space in memory 
it previously occupied). 

Names 

Routines, modules, and files all have names. The names given them may or may not bear some 
significance to one another; that depends upon you and the way that you name things. 

Conventions for the naming of files and methods of general file manipulation can be found in 
the Operating and Programming Manual and in the Mass Storage Techniques Manual. The 
conventions are not any different than for files in general. 

Names for modules are assigned with the creation of the source. In the assembly language 
source code, you have a NAM pseudo-instruction. This serves two purposes — to designate the 
beginning of the module and to assign the module a name. All of the assembly source state- 
ments which follow the NAM are in that module until an END pseudo-instruction is encoun- 
tered. Thus, recalling the previous example — 



All of the ISOURCE statements between lines 20 and 60 (in this case, just the one) form the 
module called "Example". The formal syntaxes of these pseudo-instructions are — 



{module name} 
D {module name} 



{module name} is a symbol which becomes the name of the module. It follows the same rules as 
names in BASIC: up to fifteen characters; starts with a capital letter; followed by only non- 
capital letters, numbers, or the underscore character. 
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The {module name} in the END statement must correspond to the {module name} of the NAM 
statement or an assembly error ("EN") results. 

You may have any number of modules in your source code. Each module begins with a NAM 
and ends with an END pseudo-instruction as above. 



Mass Storage 



Memory 



may or 
may not 
be on 
same 
device 




module 1 



module 2 



module 3 



module" 4 



module 5 



ICOM 
region 



User 



IDELETE module 1 



ICOM size 



;.;.;.V--,.fC)U'fi:ne^^ 




ICALL routine 1 






■:y;:'v,;.fpUttn'e''2:::.\:;:';:;;':: 


ICALL routine 2 






;.:••^'^^i?ouir1e•^;:\■^:v;';■ 


ICALL routine 3 






"^■'^■•■;fOutine''4i'';i-::;; 


ICALL routine 4 






O:;r.^rrou;tin'0:5:|;::':;':" 


ICALL routine 5 






y:K,::/::rbutin6;B::B^^^ 


ICALL routine 6 







Figure 3. Overview of Routines and Modules 

Survey of Modules and Routines 

To sketch the functional relationships of modules and routines, please refer to Figure 3 above. 

Modules are stored in files and may be retrieved and placed in memory using the "ILOAD" 
command. When the ILOAD command is executed, all of the modules in the file are loaded into 
the memory. Note that many files can be loaded, with many modules each, with all of the 
modules able to remain resident in the memory. 
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Alternatively, modules which are already in memory m.ay be stored into a single file using the 
"ISTORE" command. When the ISTORE command is executed, the designated modules are 
stored into an "option ROM" (OPRM) type of file (on tape cartridges) or an "Assembly" 
(ASMB) type of file (on non-tape mass storage media). After storage, the modules are still in 
memory. They may be removed (i.e., the space they occupy in memory is "freed") by using 
the "IDELETE" command. 

The area of memory where the modules are stored is called the "ICOM region". It is a particu- 
lar contiguous area which must be large enough to hold all of the object code you wish to have 
resident in the memory at any one time. 

Each module contains one or more routines. Your access to the routines is through the ICALL 
statement, which is very similar to the CALL statement used for BASIC subprograms. The 
ICALL statement may have arguments which you need to "pass" (send down) to the routine 
itself. What these arguments, if any, may be, and what meaning they hold depends upon what 
you have in mind for that routine. There are corresponding items in the assembly source code; 
these are discussed in Chapter 6. 

Setting Aside Memory 

As indicated by Figure 3, you cannot load a module until there is an ICOM region into which to 
load it. Neither can you assemble your source code into object code unless there is an ICOM 
region into which the object code can go. 

The statement to use to create an ICOM region is — 

ICOM {size} 

where {size} is a non-negative integer constant indicating the number of words to be used to 
form the ICOM region. The maximum size is 32 718 words. 

The ICOM statement is a "declaration"; that is, it is not executable, but rather is used when 
assignment of memory takes place just before a program is run. This is similar to a DIM or COM 
statement. As with a DIM or COM statement, the statement cannot be executed from the 
keyboard. 

Once created, the ICOM region remains in existence until it is explicitly destroyed. But it is 
possible to change the size by using another ICOM statement. 
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The order in which modules appear in the ICOM region is determined by the order in which 
they are loaded using the ILOAD statement discussed in the next section or are created by the 
lASSEMBLE statement discussed in Chapter 4. 

In most cases, the space which is freed by reducing the size of the ICOM region is returned to 
your available memory space. Sometimes, however, it is not returned, this being caused by the 
status of the common area allocated in memory, or by other option ROMs. The space is 
returned whenever — 

• There is no common area assigned (with the COM statement); and, 

• The requirements of another option ROM do not interfere. 

There may be any number of ICOM statements in a program. The current size of the ICOM 
region is determined by the last one which appears in the program when the [^ key is pressed 
(or the command RUN is executed). 

For example, suppose you have a program with the following statements in it — 

20 ICOM 934 
30 DIM R*[1003 

300 ICijM 492 



610 ICOM 2yyy 



Upon pressing [^, the ICOM region would be 2 000 words long. This is because line 610 is 
the final ICOM appearance. 

The region continues to exist even if you load in another program which contains no ICOM 
statements. All ICOM statements must appear in the main program, not in any subprogram. 

ICOM statements in a program must appear before any COM statement. This is to insure that 
the ICOM region will be allocated before the common is allocated. 
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There are three ways to eliminate the ICOM region — 

• Execute SCRATCH A 

• Execute ICOM in a program. 

• Turn off the machine. 

After any of these actions, the region is no longer in existence. If there are any modules in the 
region, they disappear as well. If any of those modules contain an active interrupt service 
routine, you get an error (number 193) if you try to eliminate the region using ICOM 0. If any of 
your routines provided to other users contain active ISRs, your documentation for the routine 
should warn the users of that fact so they can avoid this error. 

Two methods are recommended for deleting all previous modules. The methods differ only in 
the times at which the deletion operation is performed. 

The first method involves the following sequence of statements: 



1 fi 



which assures that an ICOM region of 2000 words is in existence at program^ execution, and 
that the ICOM region is completely clear of any previously loaded modules. The deletion 
operation takes place every time the (™nJ key is pressed, before program execution begins. 

The second method involves the use of the IDELETE statement in the following sequence: 

100 icon 2000 

110 IDELETE ALL 

The IDELETE statement clears the ICOM region when executed, and is executed only when it 
is encountered in a program. Therefore, the deletion of the ICOM region can be avoided by 
starting or continuing execution at a point beyond the IDELETE statement. 

When you are altering the size of the ICOM region, the new size specified becomes the size of 
the region from the moment of running the program. If the size being requested is larger than 
that which already exists, the additional space needed is requested from the operating system. 
If the space is available, everything proceeds uneventfully. If the space is not available, an erro) 
(number 2) results. To make the space available, one of the following procedures must be 
followed — 

• Execute SCRATCH A. 

• Execute SCRATCH C. 
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Each procedure has its separate effects, and the course selected should be determined by your 
circumstances at the time. Consult the Operating and Programming Manual for details on the 
other effects of each of these commands. 

If the size being requested is smaller, modules are deleted if they no longer fit into the smaller 
region. For example, suppose the following situation existed — 



'new" ICOM size^ 



'old" ICOM size 



module 
A 


module 
B 


1 

module 

C 
1 


module 
D 


module 
E 



Upon compilation of the new ICOM statement, the modules E, D, and C are deleted. None of 
those modules may contain an active interrupt service routine or an error results (number 193). 



Retrieving and Storing Modules 

Modules are stored in files on mass storage media as Option ROM (OPRM) or Assembly 
(ASMB) types of files. On tape media, they are stored in the OPRM type and on non-tape 
media they are stored in the ASMB type. In this case, the two file types are equivalent.^ 



To retrieve a module, or modules, from mass storage, identify the file name of the file contain- 
ing the module. Combine the name with the mass storage unit specifier^ of the device to form a 
file specifier. Then execute the statement — 

{file specifier} 



This retrieves all the modules in the file and stores them in the ICOM region. 

If there are modules already loaded in the ICOM region, these additional modules are added to 
them, (not written over them). If an existing module in the ICOM area has the same name as 
one of the modules being loaded, the existing module is deleted and the loaded version takes 
its place. 



1 OPRM-type files may be created by other option ROMs for their particular purposes. In those cases, the contents are entirely 
different. 

2 Not to be confused with the single-word msus described in Chapter 1. This form is used by BASIC'S Mass Storage statements 
{see the Operating and Programming Manual or Mass Storage Techniques Manual). 
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If you do not want all the modules in a given file, you can purge the unwanted ones from the 
ICOM region using the IDELETE statement — 

I DELETE {module name} [, {module name} [,...] ] 

For example, if you had loaded a file which had the routines Larry, Pat, Ed, and Piper, and you 
want to keep only Larry, then you execute the statements — 



or, more simply — 



Deletions do not have to be done immediately after loading. They can be done at any time. 
After the IDELETE has been executed, the portion of the ICOM region which the module 
previously occupied is made available for use in loading other modules. The space is NOT 
returned to the generally available memory; that action is done with an ICOM statement with a 
smaller size. 

Whenever a module is deleted, other modules are moved, as necessary, to take up any slack 
space in the ICOM region. This is done so that all of the free space in the region is at the end. If 
a module is being deleted, or being moved as above, and it contains an active interrupt service 
routine, an error results (number 193). 

No error results when an IDELETE statement is used to delete a non-existent module. 

If you desire at any time to delete all of the modules in your ICOM region, you can do so by 
executing either of the following statements — 



IDELETE ALL is the most efficient method of deleting all modules. 

Sometimes you may desire to move modules in the opposite direction — from memory to mass 
storage. This is done with the ISTORE statement. The statement has the form. — 

RE {module name} [== {module name} [=;...]] ; {file specifier} 
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A {module name} must be the name of a module currently stored in the ICOM region. Upon 
execution of the statement, a file with the name and mass storage unit specifier given in the {file 
specifier} is created and the modules are stored in the file, in the order listed. 

The file created by an ISTORE statement is an OPRM or ASMB type, as appropriate to the 
medium involved. It can then be used in ILOAD statements at a later time. 

In the case that you might want to store all of the routines currently in the ICOM region into a 
particular file, you can use either of the following statements — 

ALL i {file specifier} 
{file specifier} 



NOTE 

Executing a UitroJ|^ command during a module load, store 
or delete operation may clear the entire ICOM region. 
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Chapter O 

The Processor and 
the Operating System 



'rmstion on tHs striicturs of this 
processor and the operating system. Topics covered are: machine architecture, memory 
organization, data structures, and the machine instructions. 

Before proceeding to the actual assembly language, it is useful to discuss the processor and 
operating system with which you are dealing. This chapter discusses various concepts related to 
the processor, the machine instruction set, the operating system organization, and data struc- 
tures. 



Machine Architecture 

The System 45 has two "hybrid" processors. For the purposes of assembly language, the two 
processors function together as a single unit. The hybrid consists of a Binary Processor Chip 
(BPC), an Input-Output Controller (IOC), and an Extended Math Chip (EMC). Each has its 
own set of instructions, but all three work in conjunction. It is not necessary in using the 
assembly system that you know on which chip a particular instruction resides. In the presenta- 
tion of the instruction set — and for all practical purposes while working with the computer — 
no distinction need be made between the processors, and the entire instruction set may be 
considered as being resident on a single processor. 

In addition to the processors, the hybrid also contains an I/O bus which is controlled by certain 
instructions. The I/O bus has an "address" part and a "data" part. Some of the instructions (it 
is indicated which ones) cause an "input cycle" to occur on the bus, which means that an 
address is given to the address part of the bus, and the data which appears on the data part is 
considered to be input. Other instructions cause an "output cycle", which means that the data 
is to be output to the given "address". 

Figure 4 is a graphical representation of this architecture. 
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PROCESSOR 



TO / 
MEMORY V 



address 



data 




peripheral 
address 



data 



> 



TO 

PERIPHERAL 

DEVICES 



Figure 4. Generalized Machine Architecture 



Registers 

The memory locations in the machine are addressed from to 177777B. There are 32 memory 
locations which are addressed as if they were part of the computer read /write memory, but 
actually are part of the processor. These locations are called "internal registers". Each internal 
register has a specific location and has been given a name. As you will learn in "Symbolic 
Operations" (Chapter 4), these names have been reserved and cannot be redefined while 
using the assembly system. 

The internal registers are — 



Name 


Address 
(Octal) 


Description 


A 





Arithmetic accumulator 


Ar2 


20-23 


BCD arithmetic accumulator 


B 


1 


Arithmetic accumulator 


C 


16 


Stack pointer 


Cb 


13 


Block bit for byte pointer in C (use most significant bit only, read only) 


D 


17 


Stack pointer 


Db 


13 


Block bit for byte pointer in D (use second most significant bit only, read 
only) 


Dmac 


15 


DMA count register 


Dmama 


14 


DMA memory address register 


Dmapa 


13 


DMA peripheral address register (use lower 4 bits only) 


P 


2 


Program counter 


Pa 


11 


Peripheral address register (use lower 4 bits only) 


R 


3 


Return stack pointer 


R4 


4 


\ 


R5 
R6 


5 
6 


> I/O (Input/ Output) registers 


R7 


7 


J 


Se 


24 


Shift-extend register (use lower 4 bits only) 
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Figure 5 is a map of where these registers lie. !n addition to these registers, the addresses 25B 
through 37B are also registers, but are not (except for a few isolated cases) used in assembly 
programming. 





A 




B 




P 




R 




R4 




R5 




R6 




R7 




^rssGrvsu; 


w 


1 Pa', 


N 


K 


(reserved) 


J 




1 1 1 bmapa^l 


Db^- 


> ' ' 


Dmama 






Dmac 




C 




D 




Ar2 




ise-; 




(reserved) 



address 

1 
2 
3 
4 
5 
6 
7 
-I n 

11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 



37 



Figure 5. Map of Lowest Memory 



All of these registers can be referenced either by their names or by their actual addresses. The 
two methods are equivalent, though reference by name is recommended as a programming 
practice. 



1 See Chapter 8 for debugging considerations. 
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In addition to the above internal registers, there are some "external" registers which reside in 
the computer read /write memory. They are — 



Name 


Address 
(octal) 


Description 


Arl 


177770-177773 


BCD arithmetic accumulator 


Base_page 


177645-177655 


Base page temporary area (9 words) 


Oper_l 


177656 


Arithmetic utility operand address registers 


Oper_2 


177657 




Result 


177660 


Arithmetic utility result address register 


Utltemps 


177661-177665 


Utility temporary storage area 


Utlcount 


177666 


Used to create user utilities 



General Memory Organization 

In order to find your way around the machine effectively, you should be aware of where things 
are stored in memory. Occasionally these areas can become considerations in your program- 
ming. 

First in the memory come the internal registers. They were discussed above. 

Next in the memory comes the ICOM area. The starting location is dependent upon system 
needs, but never lower than 41B. The size of the ICOM region depends upon the size desig- 
nated by the ICOM statement. Its maximum ending address is 77756B. This is the reason for 
the limitation on the size in the ICOM statement. 

Next in the memory comes the area reserved for the system to store programs and the like. This 
area extends from the end of the ICOM region to 177644B. 

This area is followed by the registers in the read /write memory (see the list in the previous 
section) with a number of interspersed system-reserved areas. 



Figure 6 is a graphical presentation of this organization. 
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address* 


37 
40 



min=41 

max= 

11111 
100000 



177557 
177560 



177627 
177630 



177644 
177645 



177655 
177656 

177657 

177660 

177661 
177665 

177666 

M1161 
177770 

177773 
177774 



Mini 



CPU 
registers 



(reserved) 
(at least 1 word) 



user data 
(ICOM area) 



(reserved) 
(at least 17io words) 



(reserved) 



Return stack 



(reserved) 



Base_page 



Oper 1 



Oper_2 



Result 



Utitemps 



Uticount 



(reserved) 



Art 



(reserved) 



starting address 

dependent upon > '°^e^ block 

system needs 



ending address 
dependent upon 
starting address 
length of ICOM, \ 
and system 
needs 



* upper block 



*in octal representation 



Figure 6. Memory Map 



The immediately addressable memory consists of 65 536 words, which is all that can be ad- 
dressed by a 16-bit word (the basic unit of memory in the system). Note that the memory is 
divided into two blocks — an "upper" block and a "lower" one. This distinction between 
blocks becomes significant when addressing individual bytes in memory. 
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Protected Memory 

All of the reserved areas mentioned above are known as "protected memory". To give some 
measure of security to the operating system, it is advised that no attempt should be made to 
write or branch into these areas. 

Access to certain portions of protected memory (e.g., BASIC variables) is provided by utilities 
within the assembly system. The user should access those areas only through the utilities. 

Some measure of protection against access into these areas is provided during debugging. See 
the chapter entitled "Debugging" for a discussion of how this is done and the extent of the 
protection provided. 



Base and Current Page 

A concept that occasionally arises during discussion of the instructions and the assembler is that 
of the "page", the "base" and "current" pages in particular. 

A page is 1 024 words of memory. 

The "base" page is a wrap-around page. It consists of the upper half of the last page in the 
machine (addresses 177000B to 177777B) and the lower half of the zero page (addresses to 
777B). This is the same as a page which runs from - 512 to + 511, effectively "wrapping 
around" address 0. 

During execution, the program counter (P) points to the address of the current instruction. The 
"current" page is those 1 024 words of memory centered upon the current instruction. There- 
fore, the current page is a continually changing page, extending from (P)- 512 to (P)+ 511. 

Nesting of Subroutine Calls 

Assembly language subroutines are called using the JSM instruction and exited using the RET 
instruction, both of which are described later in this chapter. Subroutine calls may be nested, 
just as they are in BASIC. 

The JSM and RET instructions automatically adjust the R register (return stack pointer) so that 
the machine doesn't "lose its place" in the midst of subroutine calls and returns. The R register 
contains an address within an area of memory called the R stack, which is 40 words in size. 
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You are not free to use aii 40 words in the R stack, however. The operating system and ICALL 
require 5 words. Interrupt service routines (refer to Chapter 7 for more information on ISRs) 
require 10 words. Break points (refer to Chapter 8 for more informiation on the IBREAK 
statement) require 5 words. 

Thus, 20 words are left for the nesting of user JSMs. Calling system utilities also requires som.e 
of these 20 words. Appendix F, Utilities, contains the information necessary to determine the 
number of words needed by the various utilities. 

For example, the following program segment illustrates the use of the R stack space — 



The system does not check for R stack overflow. Violation of the R stack limits could result in a 
machine lock up. 
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Data Structures 

It is common to access BASIC variables from an assembly language routine then retrieve the 
contents, manipulate them, or alter them. To be effective at it, you should be aware of how 
BASIC stores a value in each of its data types. 

There are four data types in BASIC: full-precision numeric values, short-precision numeric 
values, integers, and strings. Each is stored in its own unique structure. 

Integers 

The simplest of the types is the integer. (Variables are declared as integers using BASIC'S 
INTEGER statement.) An integer consists of a single word. Values between - 32 768 and 
+ 32 767 can be stored in the word. Negative values are stored in two's complement form. An 
integer looks like — 



15 14 



Bit 



V 



Sign Bit 



Strings 

Strings are the next simplest structure. A string is a succession of bytes, one character to a byte. 
A string may be of variable length. To be able to designate the length, the string is preceded by 
a word which contains the number of bytes in the string. 

If a string has an odd number of bytes in it, then the left-over byte in the word containing the 
last character of the string is wasted. A typical string of length n looks like — 



n(length) 


byte1 


byte 2 


bytes 


byte 4 


bytes 


byte 6 


t . ; 


byte n-2 


byte n-1 


byte n 


- 
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Full-precision numeric values are stored as 12-digit, BCD (Binary Coded Decimal), floating 
point numbers. They occupy four words each. The first word contains the sign of the exponent, 
a two's-complement 10-bit exponent, and the sign of the mantissa. The other three words 
contain the twelve mantissa digits, 4 to each word. The words look like this — 



15 14 13 12 11 10 9 



1 Bit 



Expj 1 1 1 1 1 1 1 1 
Signi Exponent 


1 1 1 1 



Man 
Sign 


Di 

(most significant digit) 


D2 


Ds 


D4 


Ds 


De 


D7 


Ds 


D9 


Dio 


Dii 


Dl2 

(least significant) 



The exponent is always adjusted during arithmetic routines so that there is an implied decimal 
point following Di. Thus, every mantissa value looks like — 

Di . D2 Ds D4 Ds De Dy Ds Dg Dio Dii D12 



Short-Precision Numbers 

Short-precision numeric values are stored as 6-digit, BCD floating point numbers. Unlike 
full-precision, they occupy two words each instead of four. The first word contains a 7-bit 
exponent, the sign of the mantissa and the two most significant mantissa digits. The second 
word contains the remaining four mantissa digits. The words look like this — 



15 


14 13 12 


11 10 9 


8 


7 


6 5 


4 


3 


2 1 


Exp 
Sign 


1 1 1 1 1 
Exponent 


Man 
Sign 


1 1 1 
Di 


1 i 1 
D2 


D3 


D4 


Ds 


De 



As with full-precision, the exponent is stored in two's complement form and the implied deci- 
mal point follows Di. 



If you are unfamiliar with BCD arithmetic or need a refresher in floating point operations, it is 
suggested that you refer to Chapter 5. 
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Machine Instructions 

The machine instruction set underlying the assembly language system consists of 92 instruc- 
tions, divided into eleven groups. The groups are — 



Load /Store 
Integer Math 
Branch 
Test/ Branch 

Test/ Alter/ Branch 

Shift /Rotate 

Logical 

Stack 
BCD Math 
I/O 
Miscellaneous 



Operations placing values into registers or memory. 

Operations involving integer arithmetic. 

Operations altering the execution sequence unconditionally. 

Operations altering the execution sequence, dependent upon 
some condition. 

Operations altering the execution sequence and a value, de- 
pendent upon some condition. 

Operations performing re-arrangments of the bits in the A or 
B register. 

Operations performing logical functions on the A or B regis- 
ters. 

Operations managing stacks. 

Operations involving Binary Coded Decimal arithmetic. 

Operations specifically involving I/O operations. 

Some unclassifiable operations. 



Operands 

Most instructions require operands. These operands have general forms which they may assume. 

Many instructions contain an operand which is the address on which the function is to be 
performed. This {location} may be a constant (octal or decimal) or it may be a symbol. It also 
may be an expression containing any allowable combination of constants and symbols. For a 
full discussion of allowable expressions and symbols, and the "types" they are allowed to 
assume, consult "Symbolic Operations" in Chapter 4. 
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For example, note the operands in the following — 



A {location} may be either "relocatable" or "absolute" (see "Relocation" and "Symbolic 
Operations" in Chapter 4 for a full treatment of these types). If a relocatable {location} is used, 
the assembler generates machine code which uses "current page" addressing, and thus the 
{location} must be within — 512 words and +511 words of the instruction. If an absolute 
{location} is used, the assembler generates machine code which uses "base page" addressing 
(meaning it takes the address as an offset from location 0). 

An {address} is a {location} the same as above, except the intended location must be 
relocatable and within — 32 and + 31 words of the current instructions. 

A {register} may be specified either through its absolute address or by its pre-defined symbol. 
The permissible registers are those with addresses between and 7, inclusive. These are 
registers A, B, P, R, R4, R5, R6, and R7. 

A number of instructions are followed by a {value}, which is a numeric expression usually in the 
range of 1 through 16. This {value} frequently indicates the number of bits involved in the 
operation. For example — 






right-shifts the A register by 8 bits. 



NOTE 

Specifying the R4, R5, R6, or R7 registers (absolute 
locations 4 through 7) in an instruction causes an "I/O bus 
cycle" to occur. Consult Chapter 7, "I/O Handling", for the 
proper use of these registers. 
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Indirect Addressing 

Some instructions may also employ "indirect addressing". This is indicated by including the 
optional indicator . I, such as — 






There is only one level of indirect addressing provided with the processor. Of course, if further 
levels are desired, it is possible to implement them on your own. Some flagging scheme could 
be adopted, for example. One approach could be to adopt the policy that the sign bit (bit 15) of 
a word would indicate further indirection, with the remaining bits being the value. In such an 
approach, a load accumulator instruction would become two instructions — 



ShM *-i 



i!s8 curr 



ntent: 
indii 



pom 



Load/ Store Group 

This group of instructions allows transfers of data to take place. With the instructions below you 
can move information to and from the arithmetic accumulators (the A and B registers). You can 
also transfer the contents of one contiguous set of words in memory to another contiguous set. 



Instruction 



Description 



Dfl {location} [, I] 
LDE {location} [,1] 
SIP; {location} [== I] 



Si H {location} [, I] 



LR {value} 



R {value} 



Loads register A with the contents of the specified location. 

Loads register B with the contents of the specified location. 

Stores the contents of the A register into the specified 
location. 

Stores the contents of the B register into the specified 
location. 

Clears (zeroes out) the specified number of words, beginning 
at the location specified by the A register, {value} must be an 
integer between 1 and 16. 

Transfers the specified number of words, from one location to 
another. The starting address of the location being 
transferred from must be stored in the A register. The starting 
address of the location being transferred to must be stored in 
the B register, {value} must be an integer between 1 and 16. 
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integer Math Group 

This group of instructions allows you to perform fundamental arithmetic operations on the 
contents of the arithmetic accumulators (the A and B registers).^ 



Instruction 



Description 



HDfl {location} [, 1] 



RUE {location} [, I] 



MPV 



Adds the contents of the specified location to the contents of 
the A register, leaving the result in A. If a carry occurs, the 
Extend flag is set in the processor. If an overflow occurs (a 
carry from bits 14 or 15, but not both), the Overflow flag is set 






he 



:essor. 



Adds the contents of the specified location to the contents of 
the B register, leaving the result in B. If a carry occurs, the 
Extend flag is set in the processor. If an overflow occurs (a 
carry from bits 14 or 15, but not both), the Overflow flag is set 
in the processor. 

Performs a two's complement of the A register (i.e., one's 
complement, incremented by 1). If a carry occurs, the Extend 
flag in the processor is set. If an overflow occurs (a carry from 
bits 14 or 15, but not both), the Overflow flag in the 
processor is set. 

Performs a two's complement of the B register (i.e., one's 
complement, incremented by 1). If a carry occurs, the Extend 
flag in the processor is set. If an overflow occurs (a carry from 
bits 14 or 15, but not both), the Overflow flag in the 
processor is set. 

Binary multiply. Uses Booth's Algorithm. The values of the A 
and B registers are multiplied together with the product 
placed into A and B. The A register contains the least 
significant bits and the B register contains the most significant 
bits and the sign. (An anomaly in the processor results in an 
improper result whenever B equals - 32 768. ) 



1 A discussion of integer arithmetic techniques is found in the "Arithmetic" chapter of this manual. 
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Branch Group 

This group of instructions allows you to alter the execution sequence unconditionally. It 
includes the "jumps" and "returns" from subroutines. 



Instruction 



Description 



{location} [:= I] 
{location} [, I] 



{value} 



Unconditionally branches to the specified location. 

Jumps to a subroutine. The value of the R register is 
incremented and the current value of the P register (i.e., the 
location of the JSM instruction itself) is stored into the 
address pointed to by the R register. Execution then proceeds 
to the specified location. 

Returns from a subroutine, {value} is added to the contents of 
the address pointed to by the R register. The results are 
stored in the P register (i.e., specifying the next location for 
execution) and the R register is decremented. This is, in 
effect, a return from a JSM instruction to the instruction 
which is {value} instructions from the JSM itself. The "usual" 
return is RET 1. {value} must be an integer between -32 and 
31. 



The Processor and the Operating System 3-15 



lebL/ oiaiii;n oiudp 

Similar to the Branch group, this group of instructions allows you to alter the execution 
sequence, but conditionally upon the result of som.e test. Most instructions involve tests on all 
or part of one of the arithmetic accumulators (the A and B registers), but a couple allow a test 
on a location in memory which you can specify, and a couple test the current activity of the 
CRT. 



Instruction 


Description 


CPfl {location} [, I] 


Compares the contents of the A register with the contents of 




the specified location. Execution skips over the next word if 




the contents are not equal. 


CPE {location} [, I] 


Compares the contents of the B register with the contents of 




the specified location. Execution skips over the next word if 




the contents are unequal. 


SZfl {address} 


Skips to {address} if register A is 0. 


SZB {address} 


Skips to {address} if register B is 0. 


RZR {address} 


Skips to {address} if register A is not 0. 


RZE {address} 


Skips to {address} if register B is not 0. 


Slfl {address} 


Skips to {address} if register A is 0, then increments A 




regardless. The Extend and Overflow flags in the processor 




are not affected by the incrementing action. 


S I E {address} 


Skips to {address} if register B is 0, then increments B 




regardless. The Extend and Overflow flags in the processor 




are not affected by the incrementing action. 


R I H {address} 


Skips to {address} if register A is not 0, then increments A 




regardless. The Extend and Overflow flags in the processor 




are not affected by the incrementing action. 


R I E {address} 


Skips to {address} if register B is not 0, then increments B 




regardless. The Extend and Overflow flags in the processor 




are not affected by the incrementing action. 


SHC {address} 


Skips to {address} if CRT is scanning its raster. 


SHS {address} 


Skips to {address} if CRT is doing vertical retrace. 
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Test/Alter/Branch Group 

Similar to the Test/ Branch group, this group of instructions allows you to conditionally alter 
the execution sequence. In addition to tests, you can also alter the contents of the item being 
tested (such as set or clear a bit, or increment or decrement a register). Certain bits in the 
processor (Extend and Overflow) can be tested with some of these instructions, as well as 
registers and memory locations. 

Some instructions may be followed by either of the following — 



indicating that the bit being tested by the instruction will either be set (S) or cleared (C) after the 
test has been made. 



Instruction 


Description 


I SZ {location} 


[,i] 


Increment the contents of the specified location and skip 
execution of the next word if the result is 0. 


DSZ {location} 


[.I] 


Decrement the contents of the specified location and skip 
execution of the next word if the result is 0. 


SRP {address} [ 


? '-'J 


Skips to {address} if the A register is positive or zero (bit 15 is 


SRP {address} [ 


?C] 


0). 


SEP {address} [ 


? -'J 


Skips to {address} if the B register is positive or zero (bit 15 is 


SEP {address} | 


« C] 


0). 


SHM {address} | 


, bj 


Skips to {address} if the A register is negative (bit 15 is 1). 


SRM {address} | 


■ '1 
? '-J 




SEN {address} | 


? '-'J 


Skips to {address} if the B register is negative (bit 15 is 1). 


SBM {address} 


? ■-■J 




SLfl {address} | 


■! SJ 


Skips to {address} if the least significant bit of the A register is 


SLR {address} | 


„ l...'.J 


0. 


SLE {address} | 


^ -'J 


Skips to {address} if the least significant bit of the B register is 


SLB {address} 


n •...■ 1 


0. 
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instruction 


Description 


RLH {address} [,S] 


Skips to {address} if the least significant bit of the A register is 


RLH {address} [, C] 


not 0. 


RLE {address} [,S] 


Skips to {address} if the least significant bit of the B register is 


RLE {address} [=, C] 


notO. 


SOS {address} [|.S] 


Skips to {address} if the Overflow flag in the processor is set. 


SOS -f^address^ ^ . C^ 




SOO {address} [,S] 


Skips to {address} if the Overflow flag in the processor is 


SOC {address} [=0] 


cleared. 


SES {address} [,S] 


Skips to {address} if the Extend flag in the processor is set. 


SES {address} [,0] 




SEC {address} [,S] 


Skips to {address} if the Extend flag in the processor is 


SEC {address} [,C] 


cleared. 



NOTE 

The Extend and Overflow flags can be cleared only by using 
the SEC, SES, SOC, and SOS instructions with the 
option. 
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Shift/ Rotate Group 

This group of instructions performs re-arrangements of bits in the arithmetic accumulators (the 
A and B registers). Circular and non-circular shifts are available. 



Instruction 


Description 


SflR {value} 


Shifts the A register right the indicated number of bits with all 




vacated bit positions becoming 0. 


SER {value} 


Shifts the B register right the indicated number of bits with all 




vacated bit positions becoming 0. 


SflL {value} 


Shifts the A register left the indicated number of bits with all 




vacated bit positions becoming 0. 


SEL {value} 


Shifts the B register left the indicated number of bits with all 




vacated bit positions becoming 0. 


RRR {value} 


Shifts the A register right the indicated number of bits with 




the sign bit filling all vacated bit positions. (Arithmetic right) 


flER {value} 


Shifts the B register right the indicated number of bits with 




the sign bit filling all vacated bit positions. (Arithmetic right) 


RHR {value} 


Rotates the A register right the indicated number of bits. Bit 




rotates into bit 15 each time. (Right circular) 


RER {value} 


Rotates the B register right the indicated number of bits. Bit 




rotates into bit 15 each time. (Right circular) 


RhL {value} 


Rotates the A register left the indicated number of bits. Bit 15 




rotates into bit each time. (Left circular) 


r?EL {value} 


Rotates the B register left the indicated number of bits. Bit 15 




rotates into bit each time. (Left circular) 
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Luyiual Group 

This group of instructions performs logical (Boolean) operations upon the contents of an 
arithmetic accumulator (on A or B register). Logical "and" and "or" operations are available, 
along with complementing and clearing operations. 



Instruction 



Description 



{address} [== I] 



{address} [, I] 



Logical "and" operation. The contents of the A register are 
compared bit by bit, with the contents of the specified 
location. For each bit-comparison a 1 results if both bits are 
I's, a results otherwise. The 16-bit result is left in A. 

Logical "inclusive or" operation. The contents of tlfe A 
register are compared, bit by bit, with the contents of the 
specified location. For each bit-comparison, a results if both 
bits are O's, a 1 otherwise. The 16-bit result is left in A. 

Performs a one's complement of the A register (i.e., bit-by-bit 
inversion of all 16 bits). 

Performs a one's complement of the B register (i.e., bit-by-bit 
inversion of all 16 bits). 

Clears register A. This instruction is identical to SAR 16. 

Clears register B. This instruction is identical to SBR 16. 
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Stack Group 

The Stack group of instructions provides you with operations for managing stacks. The 
instructions withdraw items from (also called "pop" or "pull") or push items onto a stack 
pointed to by either the C or D register. The items are pushed from or withdrawn into a 
specified register (other than C or D) and the C or D register is incremented or decremented 
appropriately. 

Pushing instructions increment or decrement the C or D register prior to doing the pushing. 
Withdrawing instructions increment or decrement the C or D register after doing the 
withdrawal. Consequently, the pointer is always left pointing to the "top" of the stack after the 
operation. 

Decrementing the C or D register is indicated by including , D after the operand. For 
"withdrawing" instructions, D is the default. For example, the following are equivalent — 



Incrementing is specified by including , I after the operand. This is also the default for 
"pushing" instructions if neither I nor D is included. For example, the following are 
equivalent — 



The instructions for pushing and withdrawing bytes require the ability to address bytes rather 
than words. This essentially multiplies the memory map by two, requiring an additional address 
bit. When using the byte oriented stack instructions, the Cb and Db registers provide an 
additional high order bit to the C and D registers, respectively. A typical set up for pushing 
items onto a stack is as follows: 









I uet buffer address = 
' Shift -it left. 

ut it into C regis 
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A typical set up for popping items off the stack is as follows: 



Note the use of the CBL instruction in both cases. 

One use of the push and withdraw byte instructions is for input and output operations involving 
strings. Manipulating byte stacks allows byte packing of character data. The first word of the 
string storage space can be cleared initially and incremented as each character comes in. At the 
end of the transfer, the first word of the string contains the string length, making the string 
BASIC compatible. Keep in mind that the push byte instruction increments first, then pushes. 
The lower bit of the C register determines whether the upper byte or the lower byte is address- 
ed in the manner illustrated here - 



C register least significant bit 



Byte address 



Upper 
Lower 



The character string "HELLO" appears in a byte-oriented stack upon input as illustrated 
here - 



. . . 


1 


(string length) 


H 


E 


L 


L 





. . . 


. . . 


. . . 



NOTE 

When using the byte instructions (PBC, PBD, WBC, WBD), 
the address pointed to by the C or D register must not have 
an absolute address less than 40B. 
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Instruction 


Description 


PWC {register} , I 
PWC {register} [ = 


I] 


Pushes contents of {register} onto the stack pointed to by the 
C register. 


PWD {register} == I 
PWD {register} [, 


I] 


Pushes contents of {register} onto the stack pointed to by the 
D register. 


PBC {register{ , J 
PBC {register} [, 


"i 
I] 


Pushes the lower byte (right half) of {register} onto the stack 
pointed to by the Cb and C registers. If the least significant bit 
of C is a 1, the byte is placed in the lower byte of the word in 
the stack; if it is a 0, it is pushed into the upper byte. 


PED {register} , 1 
PED {register} [, 


T] 


Pushes the lower byte (right half) of {register} onto the stack 
pointed to by the Db and D registers. If the least significant bit 
of D is a 1, the byte is placed in the lower byte of the word in 
the stack; if it is a 0, it is pushed into the upper byte. 


WWC {register} [ , 
WWC {register} , '. 


D] 


Withdraws a word from the stack pointed to by the C register 
and stores it into {register}. 


WWD {register} [ , 
WWD {register} , '. 


D] 


Withdraws a word from the stack pointed to by the D register 
and stores it into {register}. 


WE C {register} [, 
WBC {register} ,, '. 


m 


Withdraws a byte from the stack pointed to by the Cb and C 
registers and places it into the lower byte (right half) of {regis- 
ter}. If the least significant bit of C is a 1 , the byte is withdrawn 
from the lower byte of the word in the stack; if it is a 0, it will 
be withdrawn from the upper byte. 


WED {register} [, 
WED {register} , " 


D] 


Withdraws a byte from a stack pointed to by the Db and D 
registers and places it into the lower byte (right half) of {regis- 
ter}. If the least significant bit of D is a 1, the byte is withdrawn 
from the lower byte of the word in the stack; if it is a 0, it is 
withdrawn from the upper byte. 


CEL 




Clears the Cb register (indicates lower block of memory). 


JELi 




Sets the Cb register (indicates upper block of memory). 


DEL. 




Clears the Db register (indicates lower block of memory). 


DELi 




Sets the Db register (indicates upper block of memory). 
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BCD Math Group 

This group of instructions provides you with BCD arithmetic operations using the Arl and Ar2 
registers. 

In general, the instructions associate the Arl register with "X" and the Ar2 register with "Y" in 
the mnemonic for the instruction. Both registers contain values which are considered BCD 
full-precision values when operated upon by instructions in this group. 

The mantissas referred to below consist of 12 BCD digits. All the shifting operations manipulate 
the digits as units (i.e., 1 digit — or 4 bits — at a time). In addition, shifting operations involve 
an additional digit in the A register (located in the lower 4 bits, numbered through 3). 

All arithmetic is performed in BCD. The values being operated upon are assumed to be nor- 
malized BCD floating-point (full-precision) values. Signs and exponents are left strictly alone. 
There is a flag in the processor, called Decimal Carry, which is set when an overflow occurs 
during a BCD operation. 

A full discussion of BCD arithmetic techniques can be found in Chapter 5. 



Instruction 



Description 



Mantissa right shift on Arl. The number of digits to be shifted 
is specified in the lower 4 bits (0-3) of the B register. The shift 
is accomplished in three stages — 

1. The digit in bits (0-3) of the A register is right-shifted into 
the first digit of the mantissa, with the twelfth digit being 
lost. This is the first shift. 

2. The mantissa digits are then right-shifted for the remaining 
number of digits specified. The twelfth digit, except for the 
last shift, is lost on each shift and the vacated digits are 
zero-filled. 



3. Finally, the last right-shift takes place with the twelfth digit 
shifting into the A register. The Decimal Carry flag in the 
processor is cleared along with the upper 12 bits of the A 
register (4-15). 
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Instruction 



Description 



riK V 



DRS 



r-IRM 



Mantissa right-shift on Ar2. The number of digits to be shifted 
is specified in the lower four bits (0-3) of the B register. The 
shift is accomplished in three stages — 

1. The digit in bits (0-3) of the A register is right-shifted into 
the first digit of the mantissa, with the twelfth digit being 
lost. This is the first shift. 

2. The mantissa digits are then right-shifted for the remaining 
number of digits specified. The twelfth digit, except for the 
last shift, is lost on each shift, and the vacated digits are 
zero-filled. 

3. Finally, the last right-shift takes place, with the twelfth digit 
shifting into the A register. The Decimal Carry flag in the 
processor is cleared along with the upper 12 bits of the A 
register (4-15). 

Mantissa left-shift on Ar2 for one digit. This is a circular shift, 
with the digit in bits (0-3) of the A register forming a thir- 
teenth digit. The non-digit part of the A register is cleared 
(i.e., bits 4-15), and the Decimal Carry flag in the processor is 
cleared. 

Mantissa right-shift on Arl for one digit. The twelfth digit is 
shifted into the A register (bits 0-3). The non-digit part of the 
A register is cleared (i.e., bits 4-15), and the Decimal Carry 
flag in the processor is cleared. The first digit in the mantissa 
is set to 0. 

Normalizes the Ar2 mantissa. The mantissa digits are left- 
shifted until the first digit of the mantissa is non-zero, or until 
twelve shifts have taken place, whichever comes first. If the 
original first digit is already non-zero, no shifts occur. The 
number of shifts required is stored as the first four bits (0-3) of 
the B register. If twelve shifts were required, the Decimal 
Carry flag in the processor is set, otherwise it is cleared. 

Ten's complement of Arl. The mantissa of Arl is replaced 
with its ten's complement and Decimal Carry is cleared. 
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Instruction 



Description 



{address} 



{address} 



Ten's complement of Ar2. The mantissa of Ar2 is replaced 
with its ten's complement and Decimal Carry is cleared. 

Fixed-point addition. The mantissas of Arl and Ar2 are 
added together, and the result is placed into Ar2. Decimal 
Carry is added to the twelfth digit. After the addition, Decimal 
Carry is set if an overflow occurred, otherwise Decimal Carry 
is cleared. 

Mantissa word addition. The contents of the B register are 
added to the ninth through twelfth digits of the mantissa of 
Ar2. Decimal Carry is added to the twelfth digit; if an over- 
flow occurs. Decimal Carry is set, otherwise it is cleared. 

Fast Multiply. Performs the multiplication by repeated addi- 
tions. The mantissa of Arl is added to the mantissa of Ar2 a 
specified number of times. The number of times is specified in 
the lower 4 bits (0-3) of the B register. The result accumulates 
in Ar2. If intermediate overflows occur, the number of times 
they occur appears in the lower 4 bits of the A register after 
the operation is complete. The upper 12 bits of the A register 
are cleared along with Decimal Carry. 

Fast divide. The mantissas of Arl and Ar2 are added together 
until the first decimal overflow occurs. The result accumulates 
into Ar2. The number of additions without overflow is placed 
into the lower 4 digits of the B register (0-3). The remainder 
of the B register is cleared, as is the Decimal Carry flag in the 
processor. 

Clears the Decimal Carry flag in the processor. 

Skips to {address} if Decimal Carry is set. Decimal Carry is a 
flag in the processor which may be set as the result of certain 
BCD arithmetic operations (see Chapter 5 for details). 

Skip to {address} if Decimal Carry is cleared. Decimal Carry is 
a flag in the processor which may be set as the result of 
certain BCD arithmetic operations (see Chapter 5 for details). 
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I/O Group 

The I/O group of instructions provides you with some of the operations necessary to accessing 
peripheral devices through the I/O bus. In addition to the instructions contained here, there 
are instructions in other groups which can have I/O effects (e.g., LDA, STA...). 

The techniques useful to the implementation of I/O operations using the instructions in this 
group and the other groups are discussed in Chapter 7. 



Instruction 


Description 


SFS {address} 


Skips to {address} if the Flag line is set (ready). The Flag line 




is associated with a peripheral on the current select code (see 




Chapter 7 for details). 


SFC {address} 


Skips to {address} if the Flag line is clear (busy). The Flag line 




is associated with a peripheral on the current select code (see 




Chapter 7 for details). 


SSS {address} 


Skips to {address} if the Status line is set (ready). The Status 




line is associated with a peripheral on the current select code 




(see Chapter 7 for details). 


SSC {address} 


Skips to {address} if the Status line is clear (busy). The Status 




flag is associated with a peripheral on the current select code 




(see Chapter 7 for details). 


EIR 


Enables the interrupt system. Cancels the DIR instruction. 


DIR 


Disables the interrupt system. Cancels the EIR instruction. 


sriu 


Sets DMA outwards. Directs that DMA operations read from 




memory, write to the peripheral. 


sni 


Sets DMA inwards. Directs that DMA operations read from 




the peripheral, write to memory. 


DMfl 


Enables the DMA mode. Cancels the DDR instruction. 


DDR 


Disables Data Request. Cancels the DMA instruction. 
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MiSi;6iian60u3 

The following instructions cannot be classified into any of the other groups. 



Instruction 



Description 



{value} [, I] 



Null operation. This is exactly equivalent to LDA A. 

The contents of any register can be treated as the current 
instruction and executed, {value} is a numeric expression in 
the range through 31, indicating the register to be used. 
The register is left unchanged, unless the instruction code 
causes it to be altered. The next instruction to be executed is 
the one in the word following the EXE, unless the code in the 
executed register causes a branch. 
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4-1 



Chapter ^ 

Assembly Language 
Fundamentals 



Summary: This chapter discusses some of the basic statements and syntaxes used 
throughout the assembly language system. Program entry, assembling, symbolic opera- 
tions, module creation, program and variable storage, and utilities are the topics co- 
vered. 



When writing assembly language programs there are a number of things with which you will be 
involved constantly. In the beginning, questions arise on how to use the language: How do you 
enter the source code? What kind of symbolic addressing is there? How do you create and 
distinguish modules? How do you create the object code and where is it stored? What utilities 
are available and how do you use them? 

The answers to those questions form the underlying capabilities through which you write your 
applications. These are things which nearly every assembly language program uses. As essen- 
tial as they are, however, none are difficult to master. 



Program Entry 



You were introduced early in Chapter 2 to the integrated nature of the assembly language with 
its host language, BASIC. You know from that chapter how assembly language statements can 
be intermingled with BASIC statements — that you can employ the usual editing features on 
the assembly statements. However, there is more to the ISOURCE statement than just its 
integrated nature with BASIC. 

As stated in Chapter 2, all assembly language statements are designated with the keyword 
"ISOURCE". The keyword is followed by {assembly language source}. So the syntax of the 
entry line is — 

{line number} [ {BASIC label} l] ISOURCE {assembly language source} 
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Here's a simple example of this from Chapter 2 — 



40 I SOURCE HHM E;camp 

59 I SOURCE HOP 

60 I SOURCE END E>:a.mp 



The {line number} and {BASIC label} are the same as you are used to in BASIC. However, it 
should be noted that the statement is not an executable one, so the BASIC label is only useful 
for documentation and EDIT purposes. 

To BASIC, the ISOURCE statement appears as a comment. If you were to change the above so 
that it read — 



^URC 



60 iSUl 

70 END 



NhM t>::ampi 

HOP 

EHD Exariipl 



and then executed a statement "GOTO Example", the result would be to simply execute the 
END statement in line 70. That is because, to BASIC, the lines appear the same as — 



4u bx-an'tpl el REM 

50 REH 

60 REM 

70 END 



or 



4u L:-^arr!pl 

50 

60 



tHll 



The BASIC label on an ISOURCE line finds its most useful characteristic in being able to be 
referenced, as any other BASIC label on any other type of line may be, with an EDIT com- 
mand. Thus, if you were to execute — 



r-jJil LxariiP 

on the above, you would be working in the editor, starting with line 40. This feature will 
become useful during program development as will be pointed out shortly. 
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Assembly Language Source 

You may have recognized the assembly language instruction and pseudo-instructions to the 
right of ISOURCE in the examples above. This is where your instructions and pseudo- 
instructions appear. However, the source is a little more versatile than that. In general, {assem- 
bly language source} has the syntax — 

[ {label} = ] {action} [ ! {comment} ] 

Or, the action may be omitted and only a comment appears — 

[ {label} = ] I {comment} 

A label is always optional in the source, but either an {action} or a {comment} must be present 
in every source line. 

Actions 

An {action} in assembly language source is — 

• A machine instruction, with any operand it may require. These were discussed at some 
length in Chapter 3. 

• A pseudo-instruction, with any operand it may require. These are discussed under the 
topics to which they relate. 

The actions contained in the above example were — 



Labels 

The {label} in assembly language source is part of the symbolic addressing capability of the 
assembler. This {label} is used by the assembler only. Neither the operating system nor BASIC 
is aware of its existence. 
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The label follows the same form and rules as do labels in BASIC — 

• Up to 15 characters long. 

• First character must be a capital letter (fl-Z). 

• Only the non-capital letters (a-z), the numerals (U to 9), or the underscore (_) may be 
used following the first character. 

No two labels are allowed to be the same in a given module. If your source consists of two or 
more modules, then the same label may be defined more than once, provided each definition is 
in a different module. (Distinguishing between modules is discussed in "Creating Modules", 
later in this chapter. ) So you may not code — 

.U\\\}jiz \ ■-■ ■'.■ 1 ; t •-.-:. In. LUn b 

in one place in the module and later in the same module code — 

Rumpel St 1 j t. sk 1 n I LDE H 

There are other restrictions as well on the choosing of labels. For instance, there are symbols 
already defined by the assembler and you are not allowed to choose one of them as a label. 
This is discussed at length in "Symbolic Operations" in this chapter. 

Both a BASIC label and an assembly language source label can appear in the same line, and 
they are distinct from one another. BASIC does not know about the source label and the 
assembly language system does not know about the BASIC label. 

Since neither BASIC nor the operating system is aware of the existence of source labels, actions 
ouside the assembler cannot reference these labels. Thus, if you had the source line — 



You can say neither GOTO Rumpelstiltskin nor EDIT Rumpelstiltskin. Neither of these can find 
"Rumpelstiltskin", since only the assembler can know it is there. 
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This can be a nuisance in some instances during program development. Many programmers 
use labels almost exclusively and rarely consider the line number when using the editor to 
change a line. For instance, in the above, they would not be used to saying, "EDIT 100" to get 
at the line in order to change it. They are more used to saying, "EDIT Rumpelstiltskin". A way 
for them to do it would be to change the line to — 



Note that, as the example demonstrates, the name can be the same in the BASIC label as in the 
source. This takes advantage of the fact that BASIC and the assembler are unaware of each 
other's labels. The names do not have to be the same. 



Comments 

As with any BASIC line, a comment may be included by simply adding an exclamation point ( ! ) 
and typing your comment after it. Since you have a total of 160 characters for a line, your 
comment may fill up the remainder of the 160 characters left after the rest of the statement has 
been provided (line number, ISOuRCE keyword, label, action). 



Syntaxing the Source 

When you are creating your source program, you are either entering it from the keyboard or 
retrieving it from mass storage (LINK or GET). In either case, as the statement is entered (the 
kroREJ i^gy Qj-j ti^g keyboard is pressed or a record is read from mass storage), the operating 
system takes note of any use of the keyword ISOURCE. When a line has this keyword, the 
operating system turns over the remainder of the line following the keyword to the assembly 
system. The assembly system, then and there, checks the syntax of the source. 



By checking the syntax at the time of entry of the statement, a considerable amount of proces- 
sing time is saved when the time comes to assemble the source into object code. In addition, it 
gives you, as the programmer, immediate feedback when a syntactical error occurs. You do not 
have to wait until assembly time just to find out that you misspelled NOP. 
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At syntax time, the assembler takes care of capitalization, lower case, and spacing for the 
source. It's quite similar to the SPACE DEPENDENT mode of entry for BASIC statements (that 
mode is not required to get the effect with the assembly system). It follows the following rules in 
syntaxing the source — 

• Everything between the ISOURCE and the colon (if present) is the label. Its initial charac- 
ter is capitalized and the remaining letters are converted to lower-case. This is regardless 
of whether they were entered in that form. 

• The label, if present, is left-justified to the second column following the keyword 
ISOURCE. 

• The first three letters following the colon (or just the first three letters, if there is no label) 
are considered the machine instruction or pseudo-instruction and are capitalized. The 
instruction will remain in the same column as it was entered, and, if possible, a space is 
added after it. 

• Everything after the instruction or pseudo-instruction is considered the operand for the 
instruction, up until the exclamation point before the comment (if any). Any label (sym- 
bol) in the operand will have its initial character capitalized and the remaining letters 
converted to lower case automatically. 

• Comments are unchanged and remain in the same columns as entered, whenever possi- 
ble. 

In short, simply enter the statement in your most comfortable fashion and the assembly system 
automatically assures that what you enter is in the proper form (though it still can't guarantee 
that you have entered the right instruction for what you mean to do). 

As a demonstration of this facility, consider the following line ready for syntaxing — 

180 ISOURCE rUriPELSTIL.TSKIN:.jripb.a! 1 

It becomes — 

100 ISOURCE Rurripel St i I tsk in: JNP Bail 
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Creating Modules 

When you were introduced in Chapter 2 to the concept of a module, it was said that a module is 
given a name through the NAM pseudo-instruction. 

So, when you enter a source line which has the following form — 

HflM {module name} 

you are assigning a name to a module, and you are also delimiting the beginning of the module. 
By the inclusion of this statement, all source lines which follow are part of the module with the 
name designated in this source line, that is, all lines until the END pseudo-instruction is encoun- 
tered in the source. It has the form — 



{module name} 

Its {module name} must be the same as in the NAM pseudo-instruction. 

A {module name} follows the same rules for naming as do labels. 

It is by the use of these two instructions that modules are created. The source lines which 
appear between them comprise a single module, and the name assigned to the module is the 
one with which the module is referenced (with the ILOAD and ISTORE statement for example). 

When it comes time to assemble the source into object code, the assembler treats the source 
lines in a module as a unit. 

In actuality, therefore, there are two modules — a source module and an object module. When 
you are assembling a module, the name you use refers to the source module and creates the 
object module. Later, other statements, such as ISTORE and ILOAD, refer solely to the object 
module. 
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Storage 

Modules 

When assembly converts a source module into an object module, there must be a place to keep 
the object module. That is the function of the ICOM region. 

You were introduced to the ICOM region in Chapter 2 in connection with the loading and 
storing of modules. It is also used to hold modules which are created through assembly. Once a 
module has been assembled, the object code appears in the ICOM region just as if you had 
loaded it from mass storage. 

Variables 

Within a module, you may want to set aside one or more words of memory for your use. For 
example, you might need a location to store a variable, or keep a counter, or save a register. 
This is done with the BSS pseudo-instruction — 

ESS {number} 

where {number} is the number of words to be set aside, {number} can be any absolute expres- 
sion, provided the expression evaluates to a positive integer (see "Symbolic Operations", later 
in this chapter). 

This kind of storage is part of the object code and is set aside "in-line". This means that 
wherever it appears in the source, the storage appears in the same relative location in the object 
module. 

For example, suppose a module contained the following source lines — 



OURCt Renras : 
OURCE Hoainl LDh 
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Then, at some appropriate spot in the object module (relative to the other instructions in the 
module) there would be the following contiguous locations — 

Save_a 1 word 

Save_4 4 words 

Renras some number of words equal to "the absolute symbol, Larry" ^ 

Again 1 word 

The locations at labels Save_a, Save_4, and Renras are merely reserved by the BSS pseudo- 
instructions, and their contents are not initialized to any particular value. 

It is possible to accidentally execute these locations when the routine is run if you're not 
careful. Ordinarily, you should place these locations somewhere safely out of the potential 
execution sequence, since they are used just for storage. Some applications, though, use 
self-generating code, and a BSS is a way to set aside locations for it. 

Data Generators 

A "data generator" is very much like a BSS operation. The function, as with the BSS, is to set 
aside words of memory at a particular location in the object code. But in addition, the words are 
to be initialized to some value. The initialization occurs at the same time the words are set aside 
(i.e., at assemble-time). 

This is done using the DAT pseudo-instruction which has the form — 

DRT {expression} [= {expression} [= ...]] 

An {expression} may be any absolute or relocatable expression. The various forms that an 
expression may take are discussed in "Symbolic Operations" later in this chapter. 

As an example, suppose you want the value 100 (a decimal integer) to be located at location 
"X" in the object module. You can achieve this by identifying the location in the source code 
(ultimately the object code) where you want the value to be, then placing this instruction at that 
point — 



1 Such symbols are discussed at length in the "Symbolic Operations" section later in this chapter. 
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Upon encountering this pseudo-instruction, the assembler generates the words necessary to 
store the value (in this case, only 1 word is necessary). It then stores the value (100) into the 
word(s) and proceeds with the remaining assembly. Thus, the location of the words is depen- 
dent upon the instruction's relative position in the source module, the same as with any 
machine instruction. 

The number of data words generated for each {expression} is dependent upon the result of the 
{expression} — 



Result 


Words 


Full-precision 


4 


Short-precision 


2 


Decimal integer 


1 


Octal integer 


1 


Address^ 


1 


Literal 


1 


String 


actual length (2 characters per word) 



If more than one {expression} is present, the necessary data words are generated in the order in 
which they appear in the list. As an example, if you were to include the instructions — 



ISOURC 
ISGURC 
ISnURf 
ISOURC 
ISOURC 
ISOURC 
ISOURC 
ISOURC 
ISOURC 
ISOURC 
I SOURC 



E 


Inteqers: 


DRT 


24,24E 


L 


Real: 


DHT 


2.4Ei,-2.4E 


E 


Short : 


DAT 


2.4EbS,4.56 


E 


String: 


liRT 


''HELLO'^ 


E 


E^strinq: 


DHT 


5, "HELLO^^ 


E 


Character: 


DHT 


••"f; 


E 


First i...iord: 


DAT 


Buffer 


E 


Buffer: 


ESS 


19 


E 


Last_i..iord: 


DHT 


*-i 


E 


Hddr_of int 


: DAT 


=3 


E 


Hddr of 3 i 


-it : DHT 


=3,4,5 



1 including "external" 
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Fort^j words would be set aside and initialized to the annroi^riate values 



@yy04i I yfiMQxH -*- decimal integer 24 

i-jidyy4i^= yytifJiiiH- -*^ octsi integer ii.t 

::::;_:" :Tr _ : : > full-precision 2.4 Ei 

000046: 000000 ; 

"iyizT:\ !^XJ^^^!^^^ [ full-precision -2.4 E5 

000052^ 000000 / 

'l'-":":::"" ZZ'ZZZ \ short-precision 2.4 E6 

iu1HdUD4: vVrMvMKi y 

Z/lVl'li' 'I'Tl't':': !• short-precision 4.567 

yyyyrjb' yb:j4yy J 

000057: 044105 \ 

000060: 046114 \ "HELLO" string 

000061: 047400 j 

000062: 000005 \ 

yyyCifr:-- 0441^5 I 

,^ . - - ^^ . - ^^_ , __ > BASIC " HELLO" string' ; first value (5) is character count 

000065: 047400 I 

000066: 000103 -► "0" character 

000067 : 000070 -*► Address of first word in ten word buffer 



000 ^-'ii: 10804bi 



s- -i - £ ^®ri word buffer (values are meaningless) 



J 



000 1 02 : 000 101 -*^ Address of last word in ten word buffer 

000 1 03 : 000 1 05 -► Address of word containing integer value 3 

000 1 04 : 000 1 06 -♦- Address of first word of an area containing three integers 

000105: 000003 -♦- Integer value 3 

000 1 06 : 000003 -► Integer value 3, first word in a group of three words 

000107: 000004 -♦- Integer value 4 

000 110: 000005 -*^ Integer value 5 



A BASIC strings must be generated for communication between BASIC and assembly language as brought about through the 
use of the Put_value (Chapter 6) and the Print_string (Chapter 7) utilities. 
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Repeating Instructions 



To help relieve the tedium of writing the same instruction many times (which many applications 
occasionally require), a "repeat" pseudo-instruction is provided — 

RElF"' {expression} 

The pseudo-instruction causes the immediately following machine instruction to be duplicated 
in the object code {expression} number of times. 

For example, suppose you are writing a real-time application where timing was critical, and to 
make things work correctly you need 10 NOPs at a certain location. Ordinarily you would 
type — 



I SOURC 


t 


NUr 


ISOURC 


j~ 


HOP 


ISOURC 


c 


HOP 


ISCURC 


E 


Hup 


ISOURC 


E 


HOP 


I SOURC 


P 


HOP 


ISOURC 


j- 


HOP 


ISOURC 


l1 


KlilP 


ISOURC 


C 


HOP 


ISOURC 


p 


HOP 



But all of this could be replaced with — 



10 I SOURCE REP 18 
20 I SOURCE HOP 



and the same effect would be achieved. 



Some pseudo-instructions may not be replicated. They are — 



COM 

•■■■•L iT; 



HRM 



;=i:::T^ 
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A U.1 • 

insseniuiiiig 

Object code is created by "assembling" the source code. Again, modules are a key factor. The 
assembly directive is aimed at modules, using the module name as a delimiter in the source 
code so the assembler can tell which ISOURCE statements to assemble as part of the module. 
Of course this same name is also used to store the object code using mass storage. 

The lASSEMBLE statement is the vehicle for assembling modules. It has the forms — 

EL.il {module} [ , {module} [ , ...]][ ; {option} [ , {option} [ , ...]]] 
ELE r ALL 1 r i (oDtionl [ . loDtionI [ , ...111 



Each {module} indicated is assembled, in the order given by the statement. Only those modules 
are assembled; any others which may be present in the source at the time are ignored. If the 
ALL version of the statement is used (with or without the optional word ALL), every module 
present in the source is assembled. 

An {option} falls into one of two categories: listing directives and conditions (for conditional 



Listing directives 



- 1 Nb. 



Conditions 



Control of indirection 



References to multiple-line functions cannot appear in the lASSEMBLE statement. If an lAS- 
SEMBLE ALL statement is executed and no source code is present, no error message is given. 
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Effect of BASIC Environments 

To assemble a module, all of its source lines (between the NAM and END pseudo-instructions) 
must lie within the same BASIC "environment". That is, the NAM and END for a module must 
lie within the main program or within the same subprogram or multi-line function. For modules 
where this is not true, an error ("EN" assemble-time error) occurs. 

Source Listing Control 

Listings of the source code in a module can be obtained during an assembly. These listings 
contain the line numbers, instructions, and comments from the source lines along with the 
associated machine addresses and contents of that address. 

Here is part of a typical listing — 



430 


01034 


002645 


Llifl 


=Hr= 


'■■a 


440 


01035 


006645 


LDE 


=firr 


"■■3. 


450 


01036 


1 4;;':-h4p; 


jsri 


Get 


i 



460 til037 y0300o LDfl Hrra;,-^t. 

470 01040 012644 CF'fl -16 

480 01041 066003 JMP -s-j-S 

499 01042 022643 HDfl =-12 

500 01043 172003 SHP *+3 

\ \ \ \ 

line absolute contents actions 
numbers addresses 



I Info on the array 

Is it a file nuuiber' 
Must be a file nurnb^ 
Is It an arra'-.-' =data. 



/ 



Ui~' 



comments 



The addresses and contents are displayed in octal representation. 

Listings are not automatic. They are obtained in one of two ways — 

• By using the LIST option in the lASSEMBLE statement. This directs that a listing is 
desired for all the modules in the statement. The statement would look like the following 
examples — 

I flSSEMBLE Ret r i eve , Work ; L I ST 



By using the LST pseudo-instruction in the source code itself. 
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modules can be just partially listed, if desired. This kind of control is achieved by using the LST 
and UNL pseudo-instructions within the source code, placing the LST before any instructions 
which you want listed, and placing the UNL before any instructions you do not want listed. For 
example, if the following source lines are assembled — 



4?H 


£Qn| \pf-p 


i ej 




430 


I SOURCE 


LDH 


=Hrray t ypt- 


440 


I SOURCE 


LDE 


=Hrr-a',' 


450 


I SOURCE 


JSM 


Get- i nf o ■ 1 


460 


I SOURCE 


LDH 


nrray type !L 


470 


ISOURCE 


CPH 


= 16 \: 


4oy 


I SOURCE 


JflP 


*+3 !!■ 


490 


ISOURCE 


flDH 


=-12 !: 


500 


ISOURCE 


SAP 


-S--I-3 i 



Inf: 






only lines 430 through 500 would be listed. 

The primary purpose of this capability is to allow as much modularity in the listings as you can 
get in source code. To implement this purpose, a "listing counter" is used. 

Whenever an LST instruction is encountered during an assembly, the listing counter is in- 
cremented. Whenever an UNL instruction is encountered during an assembly, the listing 
counter is decremented. Source lines are listed whenever the counter is greater than 0. 
Whenever it is equal to or negative, then no lines are listed. 

The counter is set to upon execution of the lASSEMBLE statement. This is why there is no 
automatic listing. However, if the LIST option is included in the lASSEMBLE statement, then 
the counter is initialized to 1. This is why that option creates a listing. Thus, you could defeat a 
LIST option by placing an UNL instruction at the beginning of a module. This initialization 
process occurs for each module assembled, so if you have more than one module indicated in 
your lASSEMBLE statement, the counter is set at the beginning of the assembly for each. 



This capability sees its greatest usefulness during debugging stages and while working with 
independently written sections of source code. For example, a number of people could be 
writing different sections of code, each containing their own LST and UNL instructions. These 
instructions could then be overridden when they were combined into a single module by 
preceding the sections with an LST instruction (to get a listing) or an UNL (to suppress the 
listings). 
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Page Format 

Each and every assembly listing page has the following format — 

• The word "PAGE" and the current page number of the listing occurs on the first line 
starting at column 49. 

• A heading occurs on the second line, left-justified. The heading always includes — 

MODULE " {name} 

where {name} is the name of the module currently being assembled. Additional heading 
information can be specified for this line (see "Page Headings" below). 

• A blank line follows the heading. 

• The text follows the blank line. The number of lines printed depends upon the LINES 
option in the lASSEMBLE statement, the number of source lines encountered, and the 
SKP pseudo-instructions which may be encountered while assembling the source. LINES 
and SKP are described in the following sections. 

• If the EJECT option is not included in the lASSEMBLE statement, then a minimum of 
three blank lines (carriage return/ line feed pairs) will be printed at the end of a page. The 
number may exceed three if the number of source lines printed on a page is less than the 
standard length for a listing page. 

Page Length 

The length of the text in each page of your assembly listings can be specified through the 
lASSEMBLE statement using the LINES option, which has the form — 

^NES {numeric expression} 



This option directs that any listing of the modules being assembled have pages of the length 
indicated by the absolute value of {numeric expression}. If {numeric expression} evaluates to a 
positive number, the listing for each module is printed on a separate page with the indicated 
number of lines. If {numeric expression} evaluates to a negative number, the pagination at the 
end of each module listing is suppressed. An error is generated if {numeric expression} 
evaluates to zero. 
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this is frequently the value selected. If the option is omitted, a value of 60 is used, producing an 
overall page size of 66 lines. 

Printer control characters, such as line-feed and form-feed, in a comment can affect the actual 
printing length of the pages independent of the length you specify. Thus, a page length of 60 
could result in actually 61 lines if one of the comments in your ISOURCE statements contains a 
line-feed character. 

End-of-Page Control 

At any time during the assembly of a module, you can force the listing to continue printing at 
the top of the next page by including — 



at the desired spot in the module. If a listing is being generated when this pseudo-instruction is 
encountered in the source code, the printer is sent to top-of-form. This is physically done in one 
of two ways — 



• If the EJECT option was included in the lASSEMBLE statement which is assembling the 
module, then a form-feed character (ASCII character 14B), is sent to the printer. This 
feature is intended for perforated paper. 

• If the EJECT option was not included, sufficient CR/LF pairs (ASCII characters 15B and 
12B) are sent to the printer to fill out the standard length of a listing page (plus three at the 
end of the page). Thus, if you already have printed 10 lines on a page, and an SKP 
instruction was encountered, the assembler sends (length -10 -I- 3) CR/LF pairs. This 
feature is intended for non-perforated paper. 

The SKP instruction is not required to cause pagination to occur when the standard length of a 
listing page is exceeded. Thus, if you are working with a default length of 60 for your standard 
length, then each 60 lines from the last page break forces a new page break. 
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Page Headings 

The heading for each listing page is 

{name} 



where {name} is the name of the module currently being assembled. This heading can have 
additional information added to it through the HED pseudo-instruction. This instruction has the 
form — 

HED {comment} 

When this instruction is encountered, and a listing is being generated, pagination immediately 
occurs, the same as with the SKP instruction (see above). On the new page, and on all pages 
after it, the indicated {comment} appears after {name} in the heading, replacing any previous 
information specified by an earlier HED instruction. 

You can change the heading any number of times in a listing. This is frequently done in order to 
generate documentation by sections, even though all sections may reside in a single module. 

The heading appears on the page exactly the same as in {comment}, including the positioning 
of blanks, control characters, etc. 

Blank Line Generation 

If occasional blank lines are desired in a listing (usually to set off sections of code, or com- 
ments), they may be generated by including — 

SPC {number} 

at the desired spot in the source statements, {number} designates the number of blank lines 
desired, {number} can be any absolute expression, provided the expression evaluates to a 
positive integer (see "Symbolic Operations" later in this chapter). 
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Non-Listable Pseudo-Instructions 

The following pseudo-instructions do not appear in a listing — 



HED 
SPC 

Conditional Assembly 

For reasons of complexity or length, it is occasionally desirable to selectively assemble only 
parts of a module. This is particularly true during the debugging stage of longer, complex 
assembly programs. "Conditional assembly" is the ability to designate certain portions of a 
module for assembly, depending upon conditions established by the lASSEMBLE statement. 

You may recall from the description of the lASSEMBLE statement earlier, there are options 
called "conditions" available with the statement. These conditions — 



are used to designate which conditions are "set" during the assembly. By including one or 
more of these conditions, all conditional assembly statements predicated upon that condition 
are assembled. For example, if the following statement is executed — 



then any occurrence of conditional assemblies based on "A" are assembled. Also, any condi- 
tional assemblies based on B through H are not assembled, since those conditions were not 
included in the options for the lASSEMBLE statement. 
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The conditional assembly sections are delimited by pseudo-instructions. A conditional section 
begins with one of the following — 



and it concludes with — 



In addition to the lettered conditions, a numeric condition can be tested by using an IFP 
pseudo-instruction. It has the form — 

IFP {absolute expression} 

The condition is considered true if {absolute expression} evaluates as a positive value. It should 
be noted that this is an assembly-time construct, meaning that the variables contained in the 
expression are evaluated at the time of assembly. 

The IFP instruction performs in the same manner as the IFA through IFH instructions. It also 
terminates with the XIF instruction. 

The conditional assembly is based upon a flag. At the beginning of the assembly for a module 
the flag is set so that object code is generated for all instructions. An IF conditional encountered 
during the assembly which does not have its condition set turns off the flag so that no further 
code is generated. Encountering an XIF statement resets the flag so that code generation can 
resume. For instance, if the source — 


















HDH 



-HTi P<:=- 
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is executed, lines 430 through 460, 480, and 490 are assembled, but 520 through 550 are not. 
Line 570 is assembled. 

The XIF pseudo-instruction actually affected both conditions. This effect is more dramatically 
illustrated if line 320 is changed to — 



where neither A nor B is set. In this case 480, 490, 520 through 550 are not assembled. But 570 
is assembled! 



The effect of the XIF, then, is as a flag for all the conditions. As a consequence, it is not possible 
to "nest" conditional assemblies. This effect is the same with the IFP conditional. 
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Control of Indirection 

The assembler can generate an indirect instruction, even when you have not specified a ,1 after 
the instruction. The pseudo-instructions lOF (indirect off) and ION (indirect on) control these 
automatic indirects. While automatic indirection is turned off (by lOF), a range error (RN) is 
generated for any instruction which the assembler would have generated an automatic indirect 
for. ION turns automatic indirection back on, restoring the assembler to its normal state. These 
pseudo-instructions are used in pairs, with lOF first and ION last, to specify an interval for 
which you wish to control automatic indirection. 

Relocation 

The code talked about in this section is relocatable. You do not have to worry about the 
absolute location of your module. The assembler automatically generates the appropriate 
machine codes for each of your instructions to assure that the correct location is reached when 
referenced. 

Some instructions generate relocatable object code in which the operand address is an offset 
from the current address and the relocating loader has to make no changes to the object code 
for them as long as they are within — 512 and -I- 511 of the current address. 

For indirect addressing, and for instructions which are more than 512 words away from the 
current address, it is required of the loader to adjust the address in the intermediate word to 
reflect the actual address being referenced. For indirect addressing generated by the assembler, 
this activity is automatic. 

Some instructions permit you to specify an absolute machine address for its operand. In those 
cases, the assembler generates the code necessary to perform the reference to the absolute 
location. 

For example, if the instruction was assembled — 



(which essentially says "load register A with the contents of register B) the result would be a 
machine instruction which references the B register (absolute address 1). This reference would 
be independent of the actual location of the instruction itself. 

There are a couple of ways to produce an absolute address in an operand. Using pre-defined 
symbols is one way. There is a type of expression known as "absolute" which is another way. 
Both of these are dicussed in the next section, "Symbolic Operations". 
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You should never try to use absolute addressing within the ICOM region, since not onl^ is the 
location of the region itself not fixed, but modules can also be moved around within the region. 

Module Reassembly 

Modules that have been assembled can be reassembled at any time. Debugging a routine often 
times leads to changes and reassembly. A discussion of this process is in order. 

The steps involved in the reassembly of two modules with the statement — 



are the following: 

• Step 1 - both modules appear in their original positions in the ICOM region. 

• Step 2 - Module_l is deleted and Module_2 is moved and linked. 

• Step 3 - Module_l is assembled. 

• Step 4 - Module_2 is deleted and Module_l is moved and linked. 

• Step 5 - Module 2 is assembled. 



Module 1 



Module 2 



Step 1 



Module_l 
deleted 



Module_2 
(Relinked) 



Step 2 



Module 2 



Module_l 
(assembled) 



Step 3 



/Module_2^ 
\ deleted 



Module_l 
(Relinked) 



Step 4 



Module 1 



Module_2 
(assembled) 



Step 5 



The impact of this is that during debugging with the stepping feature (Chapter 9), the lines of 
the reassembled modules are listed erroneously. The simple solution to this problem is to 
execute an IDELETE ALL statement before reassembling more than one module. 
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Symbolic Operations 



You have been introduced, in small doses, to symbols throughout the chapters preceding this 
one. The idea of symbols in an assembly language is the same as it is in a higher language such 
as BASIC — to make operations simpler and the code more understandable. 

Several symbolic tools are provided for you in this assembly language system. You have 
already seen one described in detail in this chapter — labels. There are some pre-defined 
symbols the assembly system provides for certain locations in the machine (mostly registers). 
There are ways to define your own symbols (and give them a "type"). And, there are ways to 
access symbols in other modules. 

Symbols can be used as operands in machine instructions and in some pseudo-instructions. 
They can be part of expressions in an operand. 

Predefined Symbols 

The assembler has predefined a number of symbols and has reserved them as references to 
special locations in memory. Each of the locations has a special meaning and function. The 
symbols themselves are "reserved", meaning they cannot be re-defined (by using them as 
labels on something else). The symbols are — 



Symbol 




Description 


A 




Arithmetic accumulator 


Arl 
Ar2 




j- BCD arithmetic accumulators 


B 




Arithmetic accumulator 


Base page 


Global temporary area (9 words) 


C 




Stack pointer 


Cb 




Address-extension bit for byte pointer in C 


D 




Stack pointer 


Db 




Address-extension bit for byte pointer in D 


Dmac 




DMA count register 


Dmama 




DMA memory address register 


Dmapa 




DMA peripheral address register 


End isr 


high 


' 


End isr 


low 


Reserved symbols for interrupt service routines 


Isr psw 






Oper 1 
Oper 2 




Arithmetic utility operand address registers 


P 




Program counter 


Pa 




Peripheral address register 


R 




Return stack pointer 
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Symbol 


Description 


R4 


\ 


R5 


I/O registers 


R6 




R7 


, 


Result 


Arithmetic utility result address register 


Se 


Shift-extend register 


Utlcount 


] 


Utlend 


\ Reserved symbols for writing utilities 


Utltemps 


J 



The meaning of each of these locations is discussed in other chapters. The absolute locations of 
the registers can be found in Chapter 2. A description of the function of the accumulators and 
pointers can be found in Chapter 3 as part of the discussion on machine instructions. A 
discussion of the I/O registers and symbols can be found in Chapter 7. The arithmetic registers 
are discussed in Chapter 5. 

Using a pre-defined symbol in a machine instruction is the same as using its address. For 
example — 



means simply that register A will be loaded with the contents of register B. The same effect 
could have been achieved with — 



URf 



LDH 



except that the symbolic form makes it more obvious what is intended by the operation. This is 
true with most symbols. 
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Defining Your Own 

You are defining your own symbol each time you specify a label on an instruction or pseudo- 
instruction. Normally the "value" of the label is the address associated with the instruction. 
However, in two cases it is possible to create the label and specify what its value is to be. One 
case is when the label is on the EQU pseudo-instruction; the other case is when the label is on 
the SET pseudo-instruction. 

The EQU is an assembly-time construct. It exists only at the time of assembly to give you 
value-assigning capability to symbols. It generates no code itself, and it has no implementation 
or "location" in the object module. 

To define a symbol using an EQU, the form is — 

{label} = EQU {expression} 

the resulting symbol { {label} ) has the same "type" as the expression (see "Expressions" later 
in this chapter) and it has the same value as the result of the expression. 

As an example, assembling the statement — 

ISOURCE Three: EQU 3 

means that in all references in the module to the symbol "Three", it is the same as referring to 
the value 3. Thus — 



means load A with the contents of location 3. 

A common use for this instruction is to assign a symbol an address which is an offset from 
another address. For example, if this sequence were in a module — 

ISOURCE S;a'v't_reqisters: ESS 40E 

ISOURCE Sa'-..'e_b: EQU Sa'-'e_reqist..ers+i 

then Save_b would refer to the second word in the BSS area "Save_registers", and it would 
probably be used to store away the contents of the B register sometime — 

ISOURCE STB Sa'..'e b 
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and later retrieve the value 



The SET pseudo-instruction defines a symbol in identical fashion to an EQU. Consequently, it 
has the same general form — 

{label} I SET {expression} 

The difference between the two is that the SET instruction can have its {label} be a symbol 
which has been previously defined. The effect in that case is to allow a redefinition of the 
symbol. For example, after assembling the following instructions — 

I SOURCE Three: EQU 3 

I SOURCE Three: SET 38E 



the symbol "Three" has the value SOB. 

Literals 

Literals are a special means of defining your own symbols without actually having to go to the 
trouble to do so. The result is a form of symbolic addressing without the symbol! The assembler 
automatically allocates space at the end of each module for the storage of literal values. This 
area is called a literal pool. 

The form of a literal is — 

= {expression} [» {expression} [=,...]] 

where {expression} may be any absolute or relocatable expression (see "Expressions" below). 

Evaluation of Literals 

When a literal is encountered in an operand, three things occur — 

1. The literal is converted to its binary value. If there is more than one expression in the 
literal, then they are all converted. 

2. The binary value is stored in a literal pool. If there is more than one expression in the 
literal, then they are stored contiguously in the order specified. 

3. The address where the value is stored is then substituted for the literal in the operand. 
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If the same literal is used in more than one instruction, only one value is generated in the literal 
pool. All instructions using this literal refer to the same location. 

Literals can be part of expressions as well as having expressions as part of them. Since they 
ultimately are replaced by an address (pointing to a specific location within a literal pool), their 
"type" is "relocatable". See the section on "Expressions" later in this chapter. 

Basically, a literal means "the address of {expression}". An example should help in the under- 
standing of literals. Suppose that you want to store the value 1 into the A register. There are 
two ways you could accomplish that purpose. You could code — 

One: DRT 1 



LDfl One 



or, you could use a literal and code — 



LHH =1 



Using the literal method is easier and is more self-documenting. While the literal form strictly 
says "load A with the contents of the address of the constant 1", it can also be read as "load A 
with the constant 1", and this short-hand version can be an excellent way of self -documenting 
your programs, not to mention the elimination of a lot of unnecessary symbols. 

The value of symbols defined with the EQU pseudo-instruction are referenced using the literal 
specifier. For example — 






Nesting Literals 

Since literals use expressions, and literals may be used in expressions, it is possible to have a 
literal within a literal (nesting). In fact, it may be done to any depth, though the most useful 
form of nesting is a single level. 
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Suppose you want to initialize a variable to the value of pi each time you enter a routine. A 
nested literal would be a way of accomplishing this in a clean, straight-forward fashion — 



LDH ==3= 14159;ib534^ 
LDB =Pi 
!--!FR 4 



and the locations starting at "Pi" now contains the full-precision value indicated (which is a fair 
approximation to pi). This would replace coding which could have looked like this (without 
using literals) — 



fl__init. : DfiT I nit. 

Init: DHT 3.1415926^ 

f\_P i : BRT P i 

Pi : ESS 4 



LliH H_rr-nt. 

LDE F!_Pi 

VfTP d. 



Literals are also used to provide an instruction or a utility (e.g., the XFR instruction and the 
Print_string utility) with the address of the first word of a string, or full-precision or short- 
precision number. In these cases the "= =" specifier is used. For example — 






puts the address of the first word of the short-precision number in the A register for the XFR 
instruction. Likewise — 



puts the address of the first word of the BASIC string "EXAMPLE" in the A register for the 
Print_string utility. (See Chapter 7, I/O Handling, for an explanation of the Print_string 
utility). 

Nonsensical Uses of Literals 

A literal, basically, is an address. Since it can be used in an operand wherever an address may 
be used, it is possible to use it in instructions where the result is a little nonsensical. 
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For example, consider the result of doing some of the following — 



:;ri ="\MHBhht." 






Caution dictates that you well consider the appropriateness of the action when using the literal. 
Literals can be a highly useful tool, but only when properly employed. 

Literal Pools 

Literals are assemble-time constructs, but they eventually resolve to an actual address in the 
object code. That address points into the literal "pool". 

The literal pool is part of your module where the actual values of literals are stored. There is 
automatically a literal pool assigned at the end of each module where literals are used. As many 
literal values as possible are stored there by the assembler. However, in some cases, a literal 
pool is needed earlier in the program (a need indicated by the assembler with the "LT" 
assembly-time error). In that case a pool should be created using the LIT pseudo-instruction. 
This instruction has the form — 

L I T {size} 

where {size} is the number of words to be set aside (it may be a positive numeric expression). 
The instruction acts very much like a BSS. And, like a BSS, it should be placed at a location in 
your code where it is not likely to be inadvertently executed. 

Most modules do not need assignment of an extra literal pool. However, one is needed where 
there is a literal used beyond 512 words from the first available space in the literal pool at the 
end of the module. To alleviate the problem, a literal pool must be created with the LIT 
statement within 512 words of the instruction. 

A common cause of this kind of problem is a large BSS assignment between the instruction and 
the end of the module. Sometimes moving the BSS to some other location is a solution to the 
problem. 
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Expri^sbiuiis 

Literals, some pseudo-instructions (particularly EQU), and a number of machine instructions, 
all permit "expressions" to be used as an operand. These expressions take one of two 
forms — "absolute" or "relocatable". The type of an expression depends upon the type of the 
individual elements in it. 

An element is of the type "absolute" if it is any of the following — 

• A decimal integer (like 0, 1, 2, 1 024). 

a A« octal in+p'-'P'- ^'ike 1 '^R 4'^B 1 nnnnOR^ 

• A string (enclosed by quote marks) (like "ERROR") 

• An ASCII character, preceded by an apostrophe (like 'A). 

• A label associated with an EQU or SET pseudo-instruction whose expression is also 
evaluative as type absolute (like EQU 40B). 

An element is of the type "relocatable" if it is any of the following — 

• A label not associated with an EQU or SET pseudo-instruction (i.e., it is an "address"). 

• A literal (like =0). 

• An asterisk, symbolizing "current address". 

• A label associated with an EQU or SET pseudo-instruction whose expression is also 
evaluative as type relocatable (like EQU *). 

An expression is a list of elements each pair of which is separated by one of the following 
operators — 



meaning addition, subtraction, division, and multiplication, respectively, as in BASIC. 

The result of an expression is either absolute or relocatable depending upon the following 
rules: 
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An absolute expression is any expression which contains — 

• Only absolute elements. 

• An even number of relocatable elements, paired in sequence and by sign (i.e., for each 
relocatable element there is another relocatable element adjacent to it, of opposite sign). 
These pairs may be in combination with absolute elements. 

A relocatable expression is any expression which contains — 

• An odd number of relocatable elements, paired in sequence and by sign, except the last, 
which must be positive. 

• An odd number of relocatable elements, as above, in combination with any number of 
absolute elements. 

Any combination of absolute or relocatable elements which does not result in either an abso- 
lute or relocatable value, by the rules above, results in an error. 

These rules and the rules for using * and can be summarized as — 



The expression is — 


The type is — 


Example 


absolute ± absolute 


absolute 


luiZiyB + ly 


absolute + relocatable 


relocatable 


1 + Temp 


relocatable ± absolute 


relocatable 


Temp - 1 


relocatable - relocatable 


absolute 


Temp 1 -• (Temp - 1 > 


relocatable + relocatable 


error 


Temp + Temp 1 


absolute - relocatable 


error 


10y0E ~ Temp 


absolute * absolute 


absolute 


100 * 3 


absolute /absolute 


absolute 


iyy-''-j 


absolute * relocatable 


error 


Temp * 3 


relocatable * absolute 


error 


3 * Temp 


absolute/relocatable 


error 


Temp--3 


relocatable / absolute 


error 


3 ■•■■'Temp 
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Unlike BASIC, there is no precedence among the operators. A.ll are of equal precedence. 
Where precedence is desired, parentheses must be used. So where BASIC requires — 

2*16+3*8 

to result in 56, the same expression in the assembly language results in 280 (assembly language 
operators are evaluated from left to right). However, 56 would be the result if it were expressed 
as — 

(2*16) + (3*8) 

An expression may be of any length and contain as many operators and parentheses as desired, 
as long as the result can be evaluated and the parentheses are properly paired. All operators 
are evaluated from left to right. Multiplication and division can only be used with elements that 
are of type absolute. 

Both operands are considered to be unsigned integers for assembler division (/). Overflows in 
all assembler arithmetic operations are ignored. 

External Symbols and Elements 

There is an additional relocatable element, called "external". It behaves in almost all respects 
as does any other relocatable element, except that only one external item may appear in an 
expression. Also, the expressions containing — 

relocatable - relocatable 

are not allowed when one of the relocatable elements is external. Externals are defined as 
symbols appearing in an EXT pseudo-instruction — 

EXJ {symbol} [, {symbol} [.,...]] 

These are entry points in another module or utility. "Entry points" are merely symbols in a 
module which are listed in an ENT pseudo-instruction in that module — 

EHT {symbol} [, {symbol} [,...]] 
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If one module contains 



J'1 I O •■•■ui'. 



then that symbol would be available to another module which contains — 



btaqe 



The EXT instruction should appear before any other instruction using the symbols which are 
listed in that EXT instruction. At execution time for a module with an EXT instruction, all of the 
symbols listed in it must be either a utility name or be contained in an ENT or SUB (described in 
Chapter 6) of another module. It is not necessary that the module be in source form; it may 
already be an object module assembled from a source module which contained the symbol as 
an ENT or SUB. 



NOTE 

When ICALLing an assembly routine, satisfaction of the ex- 
ternal symbols specified by an EXT pseudo-instruction is 
checked only for the first module after the ICALL. The ex- 
ternal symbols of modules entered after the first module are 
not checked. Undesirable results can be obtained if exter- 
nally referenced modules cannot be found. Be sure that all 
interrelated modules reside in the ICOM region before an 
ICALL is executed. 



Other Absolute Elements 

There are additional absolute elements which may be used in expressions. These are 
"machine addresses", short-precision numbers, and full -precision numbers. 

A machine address is one of the following — 

• An assembler pre-defined symbol. 

• A symbol associated with an EQU or SET pseudo-instruction whose expression is 
evaluated as a machine address (i.e., it contains a pre-defined symbol or another EQU- 
associated symbol whose expression contains a pre-defined symbol). 
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For the most part, machine addresses can be used just like absolutes. However, they remain 
defined from assembly to assembly. By defining a machine address in one module (with an 
EQU or SET), it then becomes available to you with the same value in other modules which you 
assemble. 

For example, if you were to assemble a module containing — 

I SOURCE Riijy: EijU R+lyy 



men rilvJVJ is a iiia>.^iiiiic. aiaiaiSoo i(^m^wiiiy Liic- auv-jvc luico, juSl ao ii iiic asscinuici iiav-i jjic- 

defined it. If you don't do any SCRATCH or GET statements in the meantime, then the next 
assembly you do would also have this symbol available without ever having to define it. 

When full-precision numbers (like — 2.5, 3E3, 3.141592) and short-precision numbers (like 
l.S, - 2.5S, 3.14159S, 3.E3S) are used in expressions, they become the entire expression. 
This is because these numbers are only intended as simple data-generating devices in literals 
and in DAT pseudo-instructions. Explicitly, the rules for using full- and short-precision numbers 
are — 

• They may only appear alone in an expression, i.e., they may not be in combination with 
other elements. 

• They may only appear in literals and in DAT pseudo-instructions. 
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Utilities 

A number of utilities have been provided to help make your programming tasks easier and to 
give you direct access to sorhe of the operating system's capabilities and routines. 

Descriptions of the utilities are made in conjunction with those topics where the utilities play a 
part. The form of the description of a utility is somewhat standardized. Each description will tell 
you — 

• The name of the utility. 

• The general procedure for using the utility. 

• Any special requirements which must be satisfied for the utility to work properly. 

• A step-by-step calling procedure for the utility. 

• The exit conditions. 

Utilities are a form of subroutine, so to execute them it is necessary to execute a jump-to- 
subroutine instruction (JSM) if you want the utility to return to the routine which calls it. Most 
utilities execute a RET 1 instruction to return, so in some cases where you follow a utility call 
with a RET 1 of your own, you can save the RET instruction by using the JMP (unconditional 
branch) instruction instead. For example, a typical utility call looks like — 



LDR =Teritp 
LDE =Po inter 
JSM Get element 



but if it happened to be followed by a RET 1 — 



LBfi =Temp 
LDE ^Pointer 
JSM Get_eler!ient 
RET 1 
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LDfl -Tefiip 
LDB =Poi Titer 
JNP Get elemt 



and you save a word of code: the effect is otherwise the same. Check the exit conditions for a 
utility before using this approach. 

Utilities which you use in a module must have their names in an EXT pseudo-instruction for that 
module. Otherwise, the assembler is unable to tell that you meant a utility and not one of your 
own labels, causing an "undefined reference" assembly error. 

The contents of any or all of the processor registers may be altered after a return from a utility. 
Be sure to save the contents of registers that you are using before you call a utility. 

If you are using interrupts, the interrupt system may or may not be enabled upon return from a 
utility. Use the EIR and DIR instructions to ensure the proper state of the interrupt system upon 
return from a utility. A system utility cannot be called from an interrupt service routine (ISR). 



Appendix F contains a short description of the utilities. 
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The utilities currently available are — 



Utility 



Description 



Busy 

Error_exit 

Get_bytes 

Get_elem_bytes 

Get_element 

Get_file_info 

Get_info 

Get_value 

Int_to_rel 

Isr_access 

Mm_read_start 

Mm_read_xfer 

Mm_write_start 

Mm_write_test 

Printer_select 

Print_no_lf 

Print_string 

Put_bytes 

Put_elem_bytes 

Put_element 

Put_file_info 

Put_value 

Rel_math 

Rel_to_int 

Rel_to_sho 

Sho_to_rel 

To system 



Tests the busy bits of a BASIC variable 

Aborts an ICALL statement with a particular error number 

Accesses substrings (or parts of parameters) 

Same as "Get_bytes", but used for array elements 

Same as "Get_value", but used for array elements 

Accesses the file-pointer of an assigned file 

Returns the characteristics of a variable passed as a 

parameter or existing in common 
Returns the value of a BASIC variable 
Data type conversion from integer to full-precision 
Establishes hardware linkages for interrupts 
Prepares to read a physical record from mass storage 
Reads a physical record from mass storage 
Writes a physical record to mass storage 
Verifies a physical record was written to mass storage 
Changes or interrogates select-code for standard printer 
Outputs a string with no CR-LF sequence 
Outputs a string to the standard printer 
Replaces substrings (or parts of parameters) 
Same as "Put_bytes", used for elements in an array 
Same as "Put_value", used for elements in an array 
Manipulates the file-pointer of a file 
Changes the value of a BASIC variable 
Provides access to all the arithmetic routines 
Data type conversion from full-precision to integer 
Data type conversion from full-precision to short 
Data type conversion from short-precision to full 
Allows immediate printing with printing utilities 
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Chapter O 

Arithmetic 



Summary: Arithmetic operations are reviewed and the arithmetic utilities are discus- 
sed. Floating point and BCD arithmetic are explained, as well as integer arithmetic. 



Numerical calculations are a large part of any computer's operations. Implemented within the 
System 45's processor are both integer and primitive Binary Coded Decimal (BCD) floating- 
point arithmetic operations. These operations are needed because three of the four BASIC 
variable data types (explained in Chapter 3) are represented either as BCD floating point 
numbers or as integer (binary) values. To be specific, full-precision numbers are presented as 
12-digit, BCD floating point numbers, short-precision numbers are represented as 6-digit, 
floating point numbers, and integers are represented as binary numbers. This chapter deals 
with integer and floating point operations and is intended for those readers who may have no 
acquaintance with this topic, or perhaps only a passing one. The particular machine instruc- 
tions involved with such arithmetic are reviewed. 

Because the processor provides only rudimentary floating-point operations and because com- 
plete floating-point operations (e.g., subtract, divide) are not easy to write, BCD arithmetic 
utilities have been provided to perform these calculations and are discussed later in this chap- 
ter. Integer arithmetic operations are less complex; thus utilities can be written by you, as 
described in the following section. If you are not interested in doing your own BCD or integer 
arithmetic, it is recommended that you skip immediately to "Arithmetic Utilities". 

Due to its speed increases over BCD floating point arithmetic, integer arithmetic is recom- 
mended when you are performing the addition, subtraction, or multiplication of integers. 
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Integer Arithmetic 



Representation of Integers 

Recall from Chapter 3 that integers are represented as 

15 14 



Bit 



^Sign Bit (1 = negative) 

The range of integers represented by 16 bits in the 9845 is - 
-32 767 to +32 767 

This is further illustrated in the following table - 



Decimal 


Bit- 

/ 


5 

Binary Integer Representation 


BitO 

/ 


-32 768 
-32 767 


r 

1 
1 


000 
000 


000 
000 


000 
000 


000 
000 


oo6 

001 


-1 


1 




111 

000 
000 


111 

000 
000 


111 

000 
000 


111 

000 
000 


111 

000 
001 


32 767 





111 


111 


111 


111 


111 



Notice that negative integers have their sign bit (bit 15) equal to one. There is another impor- 
tant fact concerning negative numbers - they are represented in two's complement form. This 
is done so that subtraction can be implemented by complementing and adding. There are two 
instructions (TCA and TCB) which enable you to form the two's complement of an integer. An 
example of the use of two's complement is shown - 



lU 
2fl 



OURCE Hi 



"ll JPi 



LDH 


Inteqer 


! Fir 


"id the a.bs 


BRP 


*+2 


! rif 


ari inteqe 


TCR 




! If 


not posit 






1 C Qi 


rifii lenient i 


SlH 


fibs UEllUi=- 


! S.a 


.■^e absolut 



Integer Arithmetic^ 

The addition of integers is accomplished very easily. Two instructions (ADA and ADB) are 
provided to do integer addition. A special situation to be aware of is the overflow condition. It is 
possible to add two valid 16-bit integers and produce an answer which cannot be represented 
in 16 bits. 

1 For the purposes of this manual, the terms binary arithmetic and integer arithmetic are synonomous. 
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For example, 15 000 + 25 000 = 40 000, and 40 000 is greater than 32 767 (the upper lim.it). 
The following example illustrates how to detect this condition — 












Of course, if you know that the result will be in the range -32 768 to +32 767, there is no need 
to check for the overflow condition. 

The subtraction of integers is handled almost exactly like addition. The following example 
computes (X-Y) — 






The processor contains an integer multiply instruction. There are two special considerations 
concerning integer multiplication - 

• When you multiply two 16-bit integers, the resulting product can always be represented as 
a 32-bit integer. Hence, the processor's MPY instruction produces a 32-bit answer, and 
no overflow condition is possible. However, if you would like to restrict products to a valid 
16-bit integer, you must provide your own 16-bit integer overflow check. 

• An anomaly exists in the MPY instruction. If the B register contains -32 768, the MPY 
instruction yields the wrong answer. 
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The following example multiplies two 16-bit integers (X and Y) and tests the result to see if it is 
a valid 16-bit integer - 






LDB > 




CPB ^ 


-32?^ 


JMP r 


no ma 


LDfl 'i 




MP^V 





■,y Y\, 



HrfOfi'i-S. \ 



JSM Error 
LDH E 



1P r1p^ 



Lxit = 



differ from up 



^erfloi 



! li 



rqe fl and 



u 1 1. 1 p 



The processor does not contain an integer divide instruction. However, integer division can be 
implemented quite easily. The following program implements integer division (X/Y) analog- 
ous to the BASIC DIV operator with integer operands - 






l_riH 


X 


5TH 


Dividend 


LDB 








-iTf; 


D i ■'■} 1 sor 


PZE 


Not zero 


I TiCi 


— ''• 1 


L_i_M i 




JPIP 


Error ex 


LDH 


= 


STR 


Quotient 



imq D;,.' y 






ISO 


Jki 


--b. 


ISO 


JRi 


:e 


i -iU 


JKt 


Jb 


1 30 


JRi 


--tz. 


ISO 


IPl 


Jtl 



opp p-..= H-;i..i 






CMfl 









Tliuid^ 



Llili 

i Tin 



':.m I 












■It updat 
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I SOURCE 

I SOURCE 
I SOURCE 

I SOURCE D 
I SOURCE 



I SOURCE 




T9Qijpr:E 




I SOURCE 




ISOURCE 


11 


I SOURCE 




ISOURCE 




ISOURCE 




ISOURCE 




ISOURCE 




ISOURCE 




ISOURCE 




ISOURCE 





DETE 



'-:Qi 1 



JMR Divi 



IP 



riiiit. i.r 



:;hr 1 



^HhY HRl PfiRT uF 



1 qri 



TCE 




HDE 


DiUld&nd 


SEM 


Div2 


STB 


D 1 M i dend 


LDE 


Quot i ent 


HDE 


H 


STB 


Quot i ent 


JilP 


D i ■■.'2 


LDfl 


Quot i erit 


LDE 


S i gn 


SEP 




TCP 




STH 


Quotient 


LDfl 


=Quot 1 en 


LDE 


=Quot 1 en 



quot 1 :. 









he di 



■^hniilH h^ 



Multi-Word Integer Arithmetic 

The processor does not directly support multi-word arithmetic. However, it does provide a 
register (the E register) which facilitates multi-word addition. The E register indicates whether 
there is a "carry" from bit 15 when an add instruction (ADA or ADB) is executed. 
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The following program segment illustrates how 2-word integers can be added 



I SOURCE 




SEC 


*+l.C 


! Clear h register. 


I SOURCE 




LDfi 


Hjr- i ght 




I SOURCE 




HDFi 


V r i qht 


! Forru least significant 
! hjor-d of answer; set E 

\ of bit 15= 


I SOURCE 




SOC 


*+i,C 


1 Clear overflow reyiste 


I SOURCE 
I SOURCE 




LDB 

SEC 


K left. 
Noriual 




I SOURCE 




HUE 


= 1 


! fidd in carry from leas 
! significant part. 


I SOURCE 




SOC 


Horfiial , C 


1 Q ].:•:■ r: if r"in ni...'i=-rf 1 r;i,i. 


I SOURCE 




HliB 


V ] i=-f't. 




I SOURCE 




SOS 


Uk 


• if there l^as another c 

• the answer is correct 


I SOURCE [ 


:rr20: 


LDfl 


=20 


' Give integer overflow 


I SOURCE 




JSM 


ErTor_exit 




I SOURCE 


loriia] : 


HDE 

SOS 


Err 28 





Subtraction can also be handled, by forming the two's complement. The general algorithm is 

1. Form the two's complement of the least significant, non-zero word. 

2. Form the one's complement (using CMA or CMB) of all more significant words. 



The following program segment illustrates how to compute the two's complement of a two 
word integer - 



I SOURCE 

ISOURCE 
I SOURCE 

ISOURCE 



-Dfl Riql'it word 
i'Zfl Next word 
"CM ~ 

;MB 

-DE Left word 

TH Hnswef-_righ 
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Binary Coded Decimal 



Binary Coded Decimal (BCD) uses four-bit binary codes to represent decimal digits. Thus, the 
12-digit mantissa of a full -precision number is represented by 48 bits. The BCD digits are as 
follows — 



DECIMAL 


BCD 





0000 


1 


0001 


2 


0010 


3 


0011 


4 


0100 


5 


0101 


6 


Olio 


7 


0111 


8 


1000 


9 


1001 



A BCD number within this manual has its digits represented as Di, D2, Ds, etc., with each digit 
corresponding to some BCD digit. Di is the most significant digit in a number. Since fuU- 
precison numbers within the 9845 contain 12-digit BCD mantissas, 12-digit BCD numbers are 
used as the most frequent examples in this discussion. In that case, D12 is the least significant 
digit in a number. 



Arithmetic Machine Instructions 

There are some machine instructions which specifically operate upon the BCD registers. The 
discussions in this chapter will make use of the capabilities of these instructions to develop the 
techniques to write BCD arithmetic routines. If you have not done so already, you should 
familiarize yourself with the instructions before moving on in this chapter. A description of the 
instructions can be found in "Arithmetic Group" in Chapter 3. 
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BCD Registers 



There are two registers in the machine used for BCD arithmetic — Arl and Ar2. These symbols 
are pre-defined by the assembly language to the registers' locations in memory (see Chapter 
3). The mnemonics for some instructions occasionally refer to these registers as X and Y 
respectively (see Chapter 3). 



BCD Arithmetic 



To understand BCD arithmetic in the context of the 9845, recall from Chapter 3 that a full- 
precision value is represented in four words which contain its information as follows — 



15 14 13 12 11 10 9 



7 6 



1 Bit 



Exp| 1 ' 
Signi 


1 1 1 
Exponent 


1 


1 



1 1 



Man 
Sign 


Di 

(most significant digit) 


D2 


D3 


D4 


Ds 


De 


D7 


Da 


D9 


Dio 


Dii 


Dl2 

(least significant) 



The exponent is stored in two's complement form. The exponent and the mantissa are always 
adjusted by arithmetic routines so that there is always an implied decimal point following Di. 
Thus, the mantissa of every value stored looks like — 

Di . D2 D3 D4 Ds De Dv Ds Dg Dio Dn D12 

Except possibly for intermediate results within the individual arithmetic algorithms, the most 
significant digit of a full-precision value (Di) will never be unless the entire number is 0. 
Sometimes, after an individual arithmetic operation, the answer needs to be normalized, that 
is, the digits of the answer shifted to the left until Di is no longer 0. The exponent then needs to 
be adjusted to reflect the change. 



An important thing to keep in mind when examining BCD arithmetic, as implemented by the 
processor, is that mantissas are represented in a "sign-magnitude" format. This means that the 
absolute value is stored as the actual mantissa, and the sign of the mantissa is maintained 
separately. 
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There is a one-bit Decimal Carry (DC) flag within the processor which serves a BCD function 
similar to the Extend flag for binary addition. 

DC is set to a one or zero, depending upon the occurrence or absence of a carry from the 
addition of the two Di's of the two BCD numbers being added. Since mantissas are represented 
in a sign-magnitude form (with the sign in the exponent word rather than part of what gets 
added), DC represents an overflow for 12-digit mantissa additions. 



DC itself is part of the addition in the D12 position. This gives it potential use with multiple- 
precision floating point arithmetic. The addition process looks like this — 



carry y 


n 






















DC 


/ 


Di 


D2 


D3 


D4 


Ds 


De 


D7 


D8 


D9 


D10 


D11 


D12 


/ 


























/ 


Di 


D2 


D3 


D4 


Ds 


De 


D7 


Ds 


D9 


D10 


D11 


D12 


f 




























DC 




Di 


D2 


D3 


D4 


Ds 


De 


D7 


Ds 


D9 


D10 


D11 


D12 



Ar2 
Ar2 



There are three instructions which concern themselves exclusively with DC. They are — SDS 
(Skip if DC set), SDC (Skip if DC clear), and CDC (Clear DC). 

Ten's Complement for BCD 

The addition of the ten's complement of a number is used in lieu of a subtraction mechanism. If 
the signs of the two numbers to be summed are different, one of the numbers is complemented 
(it doesn't really matter which one), before the addition. 

The ten's complement of a number with n digits to the left of the decimal point is — 

X = 10" - X 

The ten's complement of a floating-point number has the same exponent as the original 
number. Since the mantissa (M) of a full-precision number can be assumed to have the decimal 
point implied after Di, then the number must be less than 10 (but greater than 0) and the ten's 
complement of a mantissa becomes — 

M = 10 - M 



Accordingly, all that is necessary to complement a floating-point number is to complement the 
mantissa. It is immaterial whether the mantissa is treated as a 12-digit integer or as a number 
between and 10; the same sequence of digits results. 



5-10 Arithmetic 



There arc two instructions for doing ten's complements — CMX and CMY. The only difference 
between them is that CMX operates on the Arl register and CMY operates on the Ar2. 

CMX and CMY leave the exponent word of a full-precision number completely alone. This 
means that the sign of the mantissa and the entire exponent are left unchanged in a ten's 
complement by CMX and CMY. 

Ten's complement helps to accomplish addition, too. Rather than go into all of the nuances and 
subtleties of the arithmetic process, there is a simple rule for accomplishing decimal summa- 
tions using ten's complements. Assuming the exponents are the same for the numbers to be 
added — 

• If the signs of the numbers are the same, simply add them and leave the signs alone. If DC 
occurs, the result (Ar2) must be shifted to the right one place, and the exponent adjusted. 

• If the signs of the numbers are different, complement, then add. A further complementing 
action may be necessary: if DC occurs, then the result necessarily has the same sign as 
the number which was not complemeted; if DC does not occur, then the result must be 
complemented and then given the sign of the number which was complemented. 

The FXA instruction is used to add mantissas. Here is a routine to implement the rule — 



I SOURCE LDH Hrl 

ISOURCE HDfl flr2 

I SOURCE SLfl Just._add 

ISOURCE CMK 

ISOURCE FKfl 

ISOURCE LDE Hr2 

ISOURCE SDS ■*+3 

ISOURCE CMV 

ISOURCE LDE hrl 

ISijURCE STE Flr2 

ISOURCE JMP Hone 

ISOURCE j!.4st.__add: 

ISOURCE FXH 

ISOURCE SDC Done 

ISOURCE LDH =1 

ISOURCE LDE =1 

ISOURCE HRY 

ISOURCE LEfl Rr2 

ISOURCE HDR =100E 

ISOURCE STH Hr2 

ISOURCE Done: ! CONTINUE OH 



! Check the sign 

Sk ip 1 f they ar 
Compl eriient flrl 
Add the mantiss 



the 



' Was ther 
! No, so 



an overt! ou>? 

: oriip 1 ernent resu 1 1 



and switch exponents and sign 
■ ore the larger sign 



! Do the addition 

I'ias there an ooerf 1 ou'' 
Yes, so shift in a 1 
into the most 
significant digit 

HdjLJSt exponent 
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In the example just completed, you may have noted that to copy the sign the entire exponent 
word was copied. What if the exponents were different? The answer is — the exponents must 
have been the same. In fact, the only reason the example worked at all was that the exponents 
were the same. 

If exponents are different, addition of mantissas cannot proceed properly. To add the numbers 
it is necessary to make the exponents the same by shifting one of the mantissas an amount 
equal to the exponent difference. 

This difference is easily found by subtracting the smaller exponent from the larger. If the 
difference is eleven or less (the precision of the 12-digit mantissa), it is possible to offset the 
mantissa of the number with the smaller exponent. 

For example suppose there are two numbers to be added — 
X.XXXXXXXXXXX E6 



By shifting the smaller one to the right by 2 digits (the difference between 6 and 4), it is possible 
to align the exponents — 

X.XXXXXXXXXXX E6 
O.OYYYYYYYYYYYY E6 



Z.ZZZZZZZZZZZ E6 



As can be readily seen from the example, a shift of more than 11 digits would cause the smaller 
value to be all zeroes in the significant 12 digits. 

The digits to the right of the 12 most significant digits are lost in the action of shifting. That is, all 
except the left-most one. When using the MRX or MRY instructions, this digit is retained in the 
A register (bits 0-3) so that it can be used later for rounding purposes. 

To use the MRX or MRY instructions, the number of digits to be shifted must be present in the B 
register. 
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The process for this "justification" of exponents can be summed up as follows: 

• Subtract one exponent from the other storing the absolute value of the difference in the B 
register. 

• Execute the MRX shift if the Arl register is smaller; execute the MRY shift if the Ar2 
register is smaller. 



Normalization 

The raw result of an arithmetic operation (such as FXA) might not be a floating-point number 
that fits the standard form. It might have a leading DC needing to be incorporated into the 
number, as was seen in the "Addition" section earlier. Another possible deviation is a resulting 
Di of zero and no overflow. There could also be several zero-valued digits as left-most digits of 
the mantissa. 

Such situations call for "normalization". One type of normalization is accomplished with the 
NRM instruction. This instruction shifts register Ar2 left, leaving the number of shifts required in 
the B register as a binary number. The maximum number of shifts NRM performs is 12. If NRM 
must do all twelve shifts, Ar2 must have been 0. This is indicated by a value of 12 left in B and 
DC being set. For any other shift-count, NRM will leave DC at 0. 

The rules for the normalization process are — 

• Execute the NRM instruction. 

• Follow this instruction by adding the complement of the contents of B (shifted left 6 bits) 
to the Ar2 exponent unless DC is set. If DC is set, store into Ar2. 

• Test the exponent result for an underflow. 



Rounding 

The addition operation (FXA) does not automatically round a result, and there is no instruction 
which does rounding in one step. Instead, it is necessary that a series of instructions be estab- 
lished to accomplish the result. 

Recalling from "Floating Point Summations" (above) that the rightmost digit for rounding 
purposes (if any) is typically deposited in the A register by an MRX or MRY instruction, this digit 
can be checked to determine if rounding is required. 
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• Determine from register A if rounding is required (i.e., if it's greater than or equal to 5). 

• If rounding is not required, take no further action. If rounding is required, then load 
register B with 1 and execute an MWA instruction. This has the effect of incrementing the 
mantissa in Ar2 by 1. This action is an easier method than setting Arl to 1 and executing 
an FXA and it's faster, too. Don't forget to check DC for an overflow. 

• One way the sequence of rounding could appear is — 



10 


ISnURCE 


HUH —5 


! '-;-.- '' ■-■ W .-<-•.;, if-: 




20 


ISOURCE 


Sflii *-i-3 


! If less than 5, no 


rounding 


30 


ISOURCE 


LDE =1 


i Get ready to add 1 


to Hr2 


40 


ISOURCE 


MWH 


! Hdd 1 to least sign 


if leant 1 



Floating Point Multiplication 

Twelve-digit BCD floating-point multiplication is partially accomplished using the FMP instruc- 
tion. This instruction effectively multiplies the value in the Arl register by a digit contained in B 
and adds the result to a partial product in Ar2. 

Since, in the full multiplication process, exponents are merely added together, that part of the 
process is trivial. The ultimate sign of the product is also a trivial matter, determined by 
inspection of the signs of the original operands. Then the only matter of difficulty in the process 
is the actual multiplication of the mantissas. By way of explanation, assume that there are two 
mantissas to be multiplied — 

multiplicand = A B C D 
multiplier = W X Y Z 

Just four digits are used to reduce the amount of symbolism required of the example. The same 
procedures and conclusions are applicable to a full twelve BCD digits. 
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One symbolic way to indicate how this multiplication is done is — 

A B C D 
X W X Y Z 



0= partial product 
Zi Z2 Zs Z4 = Z (ABCD) X 10° 



P4 Ps Pe P? Ps = partial product 1 
Yi Y2 Y3 Y4 = Y (ABCD) X 10^ 



P3 P4 P5 Pe P? Ps = partial product 2 
Xov Xi X2 Xs X4 = X(ABCD)xl02 



P2 Ps P4 Ps Pe P? Ps = partial product 3 
Wov Wi W2 W3 W4 = W (ABCD) x 10^ 

Pi P2 Ps P4 Ps Pe P? Ps = partial product 4 (result) 

Notice that at each stage the multiple of ABCD, such as X(ABCD), must be multiplied by an 
increasing power of ten in order that the digits of the multiple line up appropriately with the 
digits of the last partial product. An equivalent procedure is to have the partial product shifted 
right one digit at each stage. 

Now, consider for a moment what is necessary within the assembly language to generate partial 
product 1 = + Z (ABCD). Ar2 must be cleared and Arl is loaded with ABCD. Z is stored into 
B in bits to 3. Then the FMP instruction is executed. Arl is added to Ar2 Z times, producing Z 
(ABCD) in Ar2. The overflow digit, Zov, ends up in the A register (bits to 3). The overflow digit 
could be any value from to 9 (each add could cause a carry, and there can be up to nine 
additions). 

To create the next partial product, a mantissa right-shift on Ar2 must occur. Notice that man- 
tissa right-shifting instructions (MRX and MRY) also shift bits to 3 of the A register into Di. 
Thus, the right-shifting of the partial product (which must occur to prepare Ar2 for the next 
partial product) also automatically takes care of retaining the overflow digit. 

Next, ABCD is added to Zov Zi Z2 Zs a total of Y times (again by use of the FMP instruction). 
Partial product 2 is created. The process is repeated for the X and W digits, producing the result 
in Ar2. 
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After the final partial product has been calculated by the final execution of the FMP instruction, 
it is possible that a non-zero digit may be present in bits 0-3 of the A register. Such a digit is 
necessarily the most significant digit of the final product. In this case, another MRY execution is 
required. Further, the exponent of the product (which was initially estimated as the sum of the 
operand's exponents) must be incremented by one to reflect this power-of-ten shift. 

Upon each step of partial product summation, a significant digit is lost due to the shift. This 
can't be helped. In general, the product of two 12-digit numbers has 24 digits of precision, but 
the bottom 12 digits must be discarded since only 12 BCD digits are stored in a mantissa. An 
error analysis of the algorithm discloses that dropping these digits causes the answer, on 
average, to be slightly smaller than it should be. However, rounding introduces a similar error, 
but in the other direction. Note that the process did not round each partial product. 

The discarded digits can be inspected before they are permanently lost. The MRY instruction 
causes the digit to be placed in the A register (in bits to 3). This provides an easy way for a 
rounding mechanism to check on those digits as they are discarded. The rounding routine 
needs to save the last digit discarded for use in rounding in the event the last use of FMP 
produces no overflow digit. 

Finally, it should be noted that you can put WXYZ into B at the very start of the process and 
simply shift B right 4 bits (with an SBR 4 instruction) between each execution of FMP. After all, 
FMP uses only bits to 3 of the register as the number of times to add Arl and Ar2. 

Floating Point Division 

There are many possible algorithms to accomplish floating-point division. The one presented 
here was chosen because of its effective use of the machine instructions and data structures 
employed by the processor and operating system. 

Remembering that full-precision numbers consist of both a signed mantissa and a signed 
exponent, use can be made of the mathematical properties of both to reduce the division 
problem to manageable proportions. Suppose that you have two full-precision values to di- 
vide — 

- 4.8E3 ^ 1.5E - 2 

The mathematical properties of exponents can be utilized and the second exponent can be 
subtracted from the first giving the exponent of the answer (subject to possible later adjust- 
ment). This is the first (and easiest) ste'^ in the division alnorithm.. 

Secondly, the mathematical properties of signs within a division process can be used to deter- 
mine the sign of the quotient from the signs of the divisor and dividend (negative quotient if the 
signs are different, positive quotient otherwise). 
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Thus, the problem can be reduced to the division of the mantissas — 
(-4.8^ 1.5) E5 

As long as the full-precision numbers have been normalized, this adjustment of the exponents 
works for any pair of exponents. The normalization of the numbers also assures that the 
division of the mantissas under the following algorithm is sufficient to produce the mantissa of 
the result. 

Since the decimal point of each mantissa is in the same place, they can be dropped altogether. 
For example — 

- 4.8 ^ 1.5 = - 48 ^ 15 

The algorithm can then consider both the divisor and the dividend as 12-digit integers. 

The algorithm begins by placing the normalized values into the BCD arithmetic registers. The 
divisor {1.5E-2 in the example) is transferred to register Arl. The dividend (- 4.8E3 in the 
example) is transferred to register Ar2. Basically, the algorithm subtracts the absolute value of 
the mantissa of Arl from the absolute value of the mantissa of Ar2 until Ar2 is smaller than Arl. 
The number of subtractions required for that to occur becomes the first digit in the quotient (it'll 
be some value between and 9 because the mantissas are normalized). If there is a (non-zero) 
remainder, then it is shifted left (multiplied by 10) and the subtraction process is repeated to 
calculate another digit in the quotient. The process is repeated until either a zero remainder 
occurs , or sufficient digits have been calculated, whichever occurs first. The resulting digits are 
merged, in order, to form the complete mantissa of the quotient. 

There are some points to keep in mind in following the algorithm — 

• Suppose you have a divisor whose normalized mantissa is larger than the normalized 
mantissa of the dividend, for example — 

15^ 48 

then the first digit of the quotient's mantissa could easily be zero. If calculation of only 
twelve digits were made, the first digit being zero would mean a loss of a significant digit. 
To guarantee that there are always at least 12 significant digits calculated for the quotient, 
it is necessary (and sufficient) to calculate 13 digits. The 13th digit can always be thrown 
away, or used for rounding, if the first digit is not zero. Thirteen digits are always sufficient 
because you can never have a quotient with two leading zeroes, if the divisor and the 
dividend are both normalized. 
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• The number of subtractions during the calculation of any digit in the quotient is always 
nine or less. Again, this is true because the divisor is normalized and its first digit is always 
non-zero. 

• At times during the algorithm, it is necessary to left-shift the mantissa of Ar2 (the mantissa 
at this point is the remainder). When shifting the remainder to the left (multiplying it by 
10), you are shifting the first digit out of Ar2. If this digit is zero, this is not a problem. But, 
if the digit is non-zero, you can't ignore it during subtractions of the divisor. This in effect 
means that you are dealing with a 13-digit dividend! Since the machine instructions deal 
in 12-digit arithmetic, it is necessary that the algorithm handle the thirteenth. 

The FDV Instruction 

The FDV instruction provided by the processor is the primary tool used to implement the 
algorithm in assembly language. The instruction works by accomplishing the equivalent of 
automatically repeated subtractions of Arl (the divisor) from Ar2 (the dividend) until Ar2 is 
smaller than Arl. The instruction actually adds the divisor to the ten's complement of the 
dividend until an overflow occurs. However, this is equivalent to subtracting until an "under- 
flow" occurs. It is easier to understand the procedure if the discussion is in terms of "subtrac- 
tions", but it should be kept in mind that what is really occurring with the instruction is repeated 
"complement-additions" until overflow. This process is what is meant by the term "subtrac- 
tions until overflow". 

The FDV instruction returns the number of subtractions without overflowing as a binary 
number in the B register (bits 0-3). The remaining bits in the B register (4-15) are cleared.^ In 
effect, then B contains the next digit in the quotient. 

This process is repeated for the number of digits to be calculated. After each FDV execution, 
the result of the overflow subtraction is left in Ar2. Since Ar2 does not contain the remainder, it 
is necessary to patch Ar2 so that it will contain the proper value for the next calculation. To get 
the proper value it is necessary to add Arl back into Ar2 to undo the results of the last 
subtraction (which caused the overflow).^ 

There is one case, however, where Ar2 does not need to be patched up, and this is when the 
remainder (Ar2) is zero. This situation implies not only that no patching up is needed, but also 
that the quotient is complete — no further digits need be calculated. It should be noted that the 
number of subtractions (which has been stored in the B register) is one count too small, thus B 
has to be incremented in this case so that it can be used as the last digit in the quotient. 

1 Since bits 4-15 of the register are cleared during execution of the FDV instruction, you can't accumulate quotient digits there. 
After each digit is calculated, it is necessary that you store the digit as part of a quotient which you keep stored in another 
location. 

2 This is equivalent to complementing Ar2, adding in Arl, then complementing Ar2 again. 
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Thirteen-Digit Dividends 

The largest difficulty in the algorithm is attempting to deal with those instances where the 
dividend has thirteen digits. This situation arises when you shift the remainder left a place. The 
most significant digit must be retained when it is non-zero so that the subtractions are sub- 
tracted from the proper amount. 

This shifting can be accomplished with the MLY instruction. With the way that the MLY instruc- 
tion operates, the left-most digit (Di) ends up being shifted out of Ar2 into register A (in the 
lower 4 bits, 0-3). Thus, the thirteen-digit algorithm must accomodate the most significant digit 
residing in the A register and the twelve least significant digits in the Ar2 register. The use of 
FDV must now take this modified situation into account. 

When the FDV instruction is executed, Arl is subtracted from Ar2 until an overflow occurs. 
When this overflow occurs, it is necessary to decrement A and keep subtracting (without 
patching up Ar2). Each time an overflow occurs, A must be decremented until finally an 
overflow occurs when A is 0. This can be handled very neatly within a small loop. 

Another aspect of dealing with thirteen-digit dividends is the count placed in B with each 
execution of FDV. Since each overflow is a "successful" subtraction in the sense that is part of 
a proper count of subtractions (at least until A is 0), then that subtraction must be counted, too. 
The difficulty with this is that FDV does not count this last (overflowing) subtraction. The 
solution obviously is to add 1 to the value in the B register each time FDV causes an overflow. 
However, with the last overflow, being the "real" overflow, the 1 shouldn't be added in, so 
after adding it in (during the loop), you have to subtract it back out again (after leaving the 
loop). To further complicate matters, if you have a zero remainder, you have to add it right 
back in again. 

For example, if there happened to be three uses of FDV for a certain quotient digit, you form 
the quotient digit as — 

Qn = (B-hl)^ +(B + 1)>K +B^ 

value after 1st value after 2nd value after final 

use of FDV use of FDV use of FDV 

If the same general situation produced a zero remainder, then the quotient digit is formed as — 

Qn = (B -H 1)^ + (B+ l)yr + {B + 1), 

value after 1st value after 2nd value after final 

use of FDV use of FDV use of FDV 
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Floating-Point Division Example 

An example of a 13-digit division routine follows. The rules which it implements are — 

1. Always increment the value returned in B after an FDV operation. 

2. After incrementing B, check the contents of A. If non-zero, loop immediately, performing 
no other tests or activities. 

3. When a quotient digit has been found (i.e., A is zero), check to see if the remainder is 0. 
If so, exit the division loop. Save the last digit found as part of the answer. 

4. If the remainder is not 0, decrement the value of the last quotient digit found and save it 
as part of the answer. Then add back the divisor to the remainder. 

The example does not include routines for testing and handling — 

• signs 

• division by zero 

• exponents 

• overflow 

• rounding 

These have to be handled in a real program before or after the division algorithm itself (as 
appropriate). 
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Arithmetic Utilities 



Now that you have been introduced to the complexities of BCD arithmetic and floating-point 
operations, this is the time to present an easier way of accomplishing these operations — the 
arithmetic utilities. 

In order to make BASIC a useful programming tool, the operating system already contains a 
number of floating-point routines. Recognizing that BCD and floating-point arithmetic can be a 
difficult and laborious task to implement, the assembly language provides a utility by which the 
operating system mathematical routines can be accessed. There are also utilities for the conver- 
sion of numerical data types. 

UTILITY: Relmath 

The Rel_math utility provides access to all of the system floating point routines and functions. 

General Procedure: The utility is told the execution address of the desired routine or function 
and is also told the number of parameters. The parameters are floating-point values stored in 
full-precision form (4 words each). The result is a full -precision value. 
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Special Requirements: 

• If one operand is passed to the utility, the address of the operand is stored in register 
Oper_l. 

• If two operands are passed to the utility, the address of the first operand is stored in 
register Oper_l (as above), and the address of the second operand is stored in register 
Oper_2. 

• The address where the result should be stored must be stored in the register Result. 

• All operands and the result are full -precision values and require 4 words each. 

• Values passed must make sense for the routine or function being called (e.g., Oper_2 
should not point to a value of when calling the division routine) , or else an error results. 

• The storage areas for the operands and the result must reside either in the ICOM region or 
in the Base page register. Specifically, they cannot be specified as Arl or Ar2. 



Calling Procedure: 

1. Assure that Oper 1, Oper 2, and Result contain the proper addresses as above. 

2. Load register A with the number of parameters required for the routine or function (see 
the table on next page). Note that some routines require this number to be com- 
plemented. 

3. Load register B with the execution address of the routine or function (see the table on 
the next page). 

4. Call the utility. 



Exit Conditions: 

• The result is placed into the 4 words starting at the address pointed to by the Result 
register. 

• Register A contains if no error is encountered during execution of the utility. 

• Register A contains the error number should an error be encountered during execution of 
the utility. 
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Table 1. Routines, Addresses, and Parameters for Rel Math Utility 



1 These functions return an integer value which is stored in the second word of the four words reserved by Result. 

2 See the System 45 Operating and Programming manual for a detailed explanation of the function of each of these routines. 

3 See the appropriate section of this manual for a detailed explanation of the function of each of these routines. 
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By way of example, suppose you have established two full-precision values which need to be 
multiplied. The call to the Rel_math utility to accomplish the multiplication would look similar 
to this — 
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Note in the last line of the example the call to the Error_exit utility is made when register A is 
not zero. When this occurs, A contains the error number of the error encountered — ready- 
made for calling the Error_exit utility. 

UTILITY: Reltoint 

The Rel_to_int utility provides for the conversion of a full -precision value into an integer. 

General Procedure: The utility is given the address of the location of the full-precision value 
and the address of the location where the integer is to be stored. 

Special Requirements: The full-precision value must be within the range of integers 
(-32 768 to + 32 767). 

Calling Procedure: 



1. Store the address of the full-precision value into register Oper_l. 

2. Store the address where the integer is to be stored into register Result. 

3. Call the utility. 
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i_xit x^uiiuitiuiis: me uvernuw bit in the proceSbur is set if the result is outside the range of 
integers. 



An example — 






Tsi 



UTILITY: Reltosho 

The Rel_to_sho utility provides for the conversion of a full-precision value into a short- 
precision one. 

General Procedure: The utility is given the address of the location of the full-precision value 
and the address of the location where the short-precision value is to be stored. 

Special Requirements: A short-precision value requires 2 words to be stored. 

Calling Procedure: 

1. Store the address of the full -precision value into register Oper_l. 

2. Store the address of the storage area for the short-precision value into register Result. 

3. Call the utility. 



Exit Conditions: The overflow bit in the processor is set if the result is outside the range of 
integers. 
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UTILITY: Inttorel 

The Int_to_rel utility provides for the conversion of an integer into a full -precision value. 

General Procedure: The utility is given the address of the location of the integer and the 
address where the full-precision value is to be stored. 

Calling Procedure: 

1. Store the address of the integer into register Oper_l. 

2. Store the address of the storage area for the full-precision value into register Result. 

3. Call the utility. 

Exit Conditions: The overflow bit in the processor is set if the result is outside the range of 
integers. 

An example — 



ISiURCE ! Working storage 
ISOURCE Operand: BSS 1 
ISOURCE Value: BSS 4 



ynt-:±it'i--- an integer 
jntai ns f ul 1 -prec i : 



JOURl 
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Jsrl Int to re-l 



! Concert integer to rea' 
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U' _ _ 

The Sho_to_rel utility provides for the conversion of a short-precision value into a full- 
precision one. 

General Procedure: The utility is given the address of the location of the short-precision 
value and the address of where the full-precision value is to be stored. 

Calling Procedure: 

1. Store the address of the short-precision value into register Oper_l. 

2. Store the address of the storage area for the full-precision value into register Result. 

3. Call the utility. 

Exit Conditions: No special exit conditions. 

An example — 

ISOURCE ! Working storaqe- 

ISUURkE s'arue; Eyy 4 ! CorYtams full -torec ision Mai ue 



ISOURCE 
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ISOURCE 
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Chapter O 

Communication 
Between BASIC and 
Assembly Language 



Summary: This chapter discusses the techniques used to pass information to and from 
assembly language programs. Calling assembly language routines and passing paramet- 
ers are presented, along with issues involved in using common. Applicable utilities are 
also discussed. 

Once assembly language programs have been written, they are executed using the ICALL 
statement. This statement is very similar to BASIC'S CALL statement for subroutines. In fact, 
the function it performs is nearly identical in effect — the onh' difference is that the target 
subroutine has been written in assembly language instead of in BASIC. The ICALL statement 
also provides a means to pass data between BASIC and assembly programs through its argu- 
ment list. Data can also be passed through common. 



The ICALL Statement 

There are two ways to execute an assembly language routine. One way is as an interrupt service 
routine when an interrupt occurs on the select code to which the service routine has been 
linked. This technique is discussed in Chapter 7. The other way is through executing an ICALL 
statement, either in a BASIC program or from the keyboard. 

The syntax of the statement is — 

ICflLL {routine name} [ < {argument} [, {argument} [, ...] J > ] 

{routine name} is the name of the assembly language routine to be executed, {argument} is a 
data item that has the same characteristics as an argument in BASIC'S CALL statement — there 
may be constants, variables, or expressions. (How these items correspond to instructions in the 
assembly language will be discussed shortly. ) 
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By way of example, suppose that you have an ICALL that is being used to call a sort routine 
and the routine was written in such a way as to require two arguments be passed to it — an 
array to be sorted and the number of elements to be sorted (in that order). Then the following 
would be valid calls to that routine — 



HL 



) , Numb: 



Upon executing the ICALL statement, execution in a program transfers to the routine named. 
Upon executing a RET 1 instruction from the main assembly language program, execution 
returns to the BASIC statement which follows the ICALL. This is identical in effect to the CALL 
statement in BASIC. 

In executing the statement from the keyboard, the routine named is executed just as if it were 
used in a program. Upon return from the routine, control is passed back to the keyboard. This is 
unlike BASIC'S CALL statement, which cannot be executed from the keyboard. 

To execute a routine, whether it be from a program or from the keyboard, its object code must 
currently reside in the ICOM region. 



Corresponding Assembly Language Statements 

When the ICALL is executed, it references a routine in the object code. When the module 
containing the routine was assembled, it declared that routine name as a "subroutine" entry 
point. ("Subroutine" and "routine" are synonymous in this context.) This is done with a SUB 
pseudo-instruction and a label. 

When a SUB pseudo-instruction appears in the source code, it is a signal to the assembler that a 
subroutine entry point follows. Then the first machine instruction must have a label and that 
label becomes the routine name. If the label is missing, an error results (assembly-time "SQ" 
error). 

For example, in the above examples of ICALL, the Sort routine could have been defined by the 
sequence — 






except that there are arguments involved. (That exception is discussed in a moment.) The joint 
use of these two statements results in the label "Sort" being identified as a routine name, 
referenceable with an ICALL statement. 
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In general, no machine instructions or code-generating pseudo-instructions can be inserted 
between a SUB pseudo-instruction and the instruction containing the routine name. An excep- 
tion to this exists when arguments are involved in a call. 

Arguments 

When a value is placed into an ICALL statement to be sent down to an assembly language 
routine, that value is called an "argument" (like the argument of a mathematical function). The 
corresponding structure on the assembly language side is called a "parameter". A parameter 
"declaration" is an assembly pseudo-instruction by which a parameter is created. 

When a routine is to be called with arguments, a parameter declaration pseudo-instruction is 
required for each one of the arguments. These declarations appear between the SUB pseudo- 
instruction and the instruction containing the routine name. 

Thus, when there is a call like — 



the corresponding assembly language entry looks like — 



To accommodate the two arguments, two parameter declarations had to appear between the 
SUB instruction and the entry point. (In this example, they were the STR and REL declara- 
tions.) These declarations may even have labels of their own — 






The appearance of these labels does not affect the fact that "Sort" is the name of the routine. 
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Parameter declarations have "types" just like variables. These types have to correspond to the 
"types" of the arguments used in the ICALL. The declarations and their types are — 

I HI meaning integer 

REL meaning full-precision 

SHO meaning short-precision 

SIR meaning string 

F I L meaning a file number 

In the above example, STR had to be used as the first parameter declaration because the first 
argument was a string. Similarly, REL had to be the second declaration because the second 
argument was a numeric expression (which is always full-precision). 

When an array is to be passed, the declaration is followed by an "array identifier" — ( * ). Thus, 
when arrays are involved, the declarations appear as — 

I HI (. * > meaning an integer array 

REL < * y meaning a full-precision array 

SHO ■:> > meaning a short-precision array 

STR < * ':.' meaning a string array 

File numbers are not passed in arrays, so that the declaration FIL cannot be followed by an 
array identifier. When passing file numbers to assembly language routines, the file number 
must be preceded by a "#" character. 

ICALL Sort (#File_number, Entries, Type) 

Failure to include the "#" before the file number or file number variable results in an error. 

Since the example call above uses a string array as the first argument, the corresponding 
assembly language parameter declaration uses an array identifier after STR. 

The parameter declarations are associated with the arguments in the ICALL in the same order. 
If the types do not match when the ICALL is executed, an error occurs (number 8). 

So, if the subroutine entry looks like — 

I SOURCE: STR <*> 

I SOURCE REL. 

I SOURCE Sort.: LDfl ™Hrray info 
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but these ICALLs result in run-time errors — 



Each declaration reserves three words in the object code upon assembly. As a result of the 
ICALL execution, these words contain a descriptor of the corresponding argument. These 
descriptors are used by the utilities for fetching and storing values. Thus, in the Sort calling 
example above, when the ICALL is executed, a descriptor for Test$(*) is stored in the three 
words starting at Parameter_l. Similarly, a descriptor for the constant 100 is stored in the three 
words starting at Parameter_2. 

The types discussed here do not apply just to simple variables, arrays, and constants. They also 
apply to single elements of arrays and expressions. If you have a STR parameter declaration, 
for example, any of the following would be valid as arguments in the ICALL statement — 

ri-iPi: { i v'7 ''\y..T ■-■■- t % 
RPT$( •■fl", 20) 

Tests CI, St. OP 3 



It is similar for numerical expressions. 

The number of arguments passed by an ICALL statement must be no more than the number of 
parameter declarations in the subroutine entry. There may be fewer, however. The actual 
number passed is stored in the word reserved by the SUB pseudo-instruction. 

Unlike the CALL statement in BASIC, the ICALL statement can be executed from the 
keyboard. In doing so, any variables used as arguments pass their current values to the routine. 
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"Blind" Parameters 

With explicit parameter declarations, an error occurs if a different type of variable or expression 
is passed. In many cases, the error is desirable — you do not want different types of arguments 
corresponding to a single parameter declaration. But in other cases, the error might not be as 
desirable. Take the example of a sort. You might want the sort to have the capability of sorting 
any type of array. You have two choices in that case — you can make different routines, each 
with the appropriate declarations, or you can use a single entry point and the ANY parameter 
declaration. 

The ANY declaration — 

HHY 

is "blind" to the type of the corresponding argument in the ICALL statement. When used, it 
accepts any type of argument as valid — string, full-precision, short-precision, integer, file 
number, array. The descriptor for the argument is stored in the three words set aside, just as in 
the other declarations. 

Now, if your entry looks like — 

I SOURCE SUE 

ISGUPCE HNY 

then any of the following calls would be valid — 

ICRLL Sort U tst.$(*>, 190) 
ICRLL Sort (Test <*:>, IQij) 

ICflLL Sort (#i , 100) 

When using the ANY declaration, it becomes the responsibility of your assembly language 
routine to determine what is a valid parameter and what is not. You lose the automatic type- 
checking available with explicit declarations. Techniques for doing this are discussed in the 
next section. 
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Getting Information on x^miguments 

When an ICALL is executed with an argument, and the corresponding parameter is blind, then 
it may be necessary for the purposes of your routine to know what type of argument is actually 
passed. This need can be present even when one of the explicit type declarations is used, since 
an expression or constant can be passed as easily as a variable. 

A utility has been provided for obtaining this information, along with other "vital statistics" 
which may be useful to know during the execution of your routine. Before describing the utility 
itself, let's look at the information which it can provide you about an argument. 

The information returned by the utility is stored in an area which you set aside for it. The size of 
the area can vary from 3 words to 39. The information, when returned, is in the following 
form — 



Word# 



Description 



Argument type (see description later) 

Number of dimensions (0 for non-arrays) 

Size, in number of bytes (dimensioned length, for strings) 



(for arrays only:] 



3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 



Total number of elements in array 

Two's complement of the lower bound of first dimension 

Absolute size of first dimension (upper bound — lower + 1) 

Two's complement of the lower bound of second dimension (if any) 

Absolute size of second dimension 

Two's complement of the lower bound of third dimension (if any) 

Absolute size of third dimension 

Two's complement of the lower bound of fourth dimension (if any) 

Absolute size of fourth dimension 

Two's complement of the lower bound of fifth dimension (if any) 

Absolute size of fifth dimension 

Two's complement of the lower bound of sixth dimension (if any) 

Absolute size of sixth dimension 

Element offset (from the first element) 

Size, in words, of each element (dimensioned length, for strings) 



(dependent upon memory size of your machine:) 



18-20 
21-23 
24-26 
27-29 
30-32 
33-35 
36-38 



Pointer parameters 

Pointer parameters (only for machines over 
Pointer parameters (only for machines over 
Pointer parameters (only for machines over 
Pointer parameters (only for machines over 
Pointer param.eters (onl" for machines over 
Pointer parameters (only for machines over 



64 K bytes) 
128K bytes) 
192K bytes) 
256K bytes) 
320K b"tes) 
384K bytes) 
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The argument type returned in word is as follows 



Value 


Type 





String expression 


1 


Full-precision expression 


2 


Short-precision expression 


3 


Integer expression 


4 


String simple variable 


5 


Full-precision simple variable 


6 


Short-precision simple variable 


7 


Integer simple variable 


8 


String array element 


9 


Full-precision array element 


10 


Short-precision array element 


11 


Integer array element 


12 


String array 


13 


Full-precision array 


14 


Short-precision array 


15 


Integer array 


16 


File number 



The size, in bytes, will be one of the following values — 



For an integer 


2 


Short-precision 


4 


Full-precision 


8 


String variables 


dimensioned length 


String expressions 


actual length 



The utility which retrieves all this information is called "Get_info". 



UTILITY: Getinfo 

General Procedure: The utility is given the address where the information is to be returned 
and the address of the parameter declaration. It returns with the information on the argument 
in the ICALL corresponding to the parameter declaration. 
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Special Requirements: 

• The location where it is to store the information must be adequate to hold all that may be 
returned. For non-arrays, 3 words will suffice. For arrays, up to 39 words may be required 
(as above). If you are writing a general routine, it may be wise to play it safe by setting 
aside a full 39 words. 

• An argument must have been passed by the ICALL (in the case of parameters) or a 
corresponding BASIC COM declaration must exist (in the case of common declarations).^ 

Calling Procedure: 

1. Load register A with the address of the storage area for the information to be returned. 

2. Load register B with the address of the parameter declaration corresponding to the 
desired argument. 

3. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the JSM. Since there are no error exits, and there is no requirement that there be as 
many arguments as there are parameter declarations, an argument must actually have been 
passed by the ICALL in order for the utility to work correctly. 

Following up on the example in the previous section, suppose the first thing that the Sort 
routine does is check to see if the first parameter passed is an array. Then, by using the 
Get_info utility, it is possible to have the instructions look as follows — 



Vti, indii_a.tt- s^rur- h 



SRr *+2 I fln array ^type; 



1 This and the following utilities are also used to access variables in the common area. An explanation of BASIC COM 
declaration is found in the section of this chapter entitled "Using Common". 
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The array information returned by the Get_info utility is used for accessing elements in arrays 
passed as arguments. It is used by the element-retrieval utilities described in a later section of 
this chapter. Once retrieved, the information is usable any number of times for accessing the 
array associated with it. It is not necessary to retrieve the information every time you access an 
array, as long as you have not altered the information (except the pointer) between accesses. 

The seventeenth word of the array information (word 16 on the chart) is reserved to hold the 
offset from the start of the array of the element to be accessed. Therefore, it is permissible 
(indeed, it is necessary) to alter the contents of that location to indicate which element in the 
array you wish to retrieve. None of the other words returned by the utility should be changed. 

An example of how to calculate array offsets is given here. It is convenient to give labels to 
some of the words of information returned by the Get_info utility. 

I SOURCE Lower! : ESS 1 

I SOURCE Sizei: ESS 1 

ISOURCE Loi.ier2: ESS 1 

I SOURCE Size2: ESS 1 

ISOURCE Loi,..ser3: ESS 1 

ISOURCE Loi.oer4: ESS 1 

ISOURCE Size4: ESS i 

ISOURCE LoioerS: ESS 1 

ISOURCE Size5: ESS 1 

ISOURCE Lo!.ier6: ESS 1 

ISOURCE SizeS: ESS 1 

ISOURCE El erntnt : ESS i 

In addition, space is reserved for up to six array subscript indices. 

ISOURCE Indexl I ESS 1 

ISOURCE Iridex2: ESS 1 

ISOURCE IndexO: ESS 1 

ISOURCE IndexS: E£iS 1 
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For a six-dimensional array, the computation of the element offset (word 16 returned by 
"Get info") is - 



filjn 






URGE 


ADA 


T l--;H 


URGE 


STiS 


Lq|.|5 


iURHF 


LDE 


c -: -I- 


URGE 


MPY 




lURCE 


FiDR 


Ind 


URGE 


flDH 


Louif 


URGE 


LDB 


Si z 


URGE 


MPY 




URGE 


HDH 


I nd 


URGE 


HDH 


LOi...i^ 


URGE 


cjh 


E1 e 



ml 



For an array with a smaller number of dimensions, the operations involving the higher sub- 
scripts can be omitted. 

Note that the indices in this example were not checked against the array bounds. Following is 
an example of a program segment which checks the index against the upper and lower bounds 
of a one-dimensional array: 



4nd 



There is no need to check for overflow, since the element offset is never greater than 32 767. 



When making multiple accesses with the same information, caution should be taken if an array 
is involved. The information returned by Get_info is a copy of the system information and as 
such rem.ains valid for as long as the ICALL lasts. However, as soon as an ICALL comipletes, 
the system has an opportunity to change its own information (via REDIM or subprogram 
recursion). This renders the original data returned by Get info invalid. 
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Thus, while it is sufficient to call Get_info only once during an ICALL (independent of the 
number of times the information is used), it is advisable to use Get_info during each ICALL 
rather than attempting to retain the information from one ICALL to the next. 



Retrieving the Value of an Argument 

At some point during execution of your assembly language routine, you may want to retrieve 
the value of an argument so that you can use it in your processing. By doing so, you accomplish 
one of the methods of communicating with assembly language — namely, passing a value to 
the assembly language routine from BASIC. 

There are a number of utilities for this purpose. The one to use is dependent upon the type of 
argument passed. The utilities available are — 



Name 



Get_value 

Get_element 
Get_bytes 

Get elem bytes 



Used For 



Simple variables, expressions, individual elements 
of arrays passed as arguments, and file numbers 

Elements (from arrays passed as arguments) 

Substrings of strings passed as arguments either as 
simple string variables, expressions, or individual 
elements of arrays passed as arguments 

Substrings of individual elements (from string 
arrays passed as arguments) 



Example Parameters 



Alpha,Z*SIN(Z),A$,"ABC' 
B$(10),Array(2,3),#5 

Array(*),Z$(*) 

"DEF",String$,B$&C$, 
Z$(2,3),Z$[5,6] 

Z${*) 



How each of these utilities is used is described in the immediately following pages. 



UTILITY: Get value 



General Procedure: The utility is given the address of the parameter declaration and the 
address where the value of the argument is to be stored. It returns with that value stored in the 
indicated area. It works on simple variables, expressions, strings, and individual elements of 
arrays (passed as arguments) of any type. 
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• The storage area set aside for the value must be large enough to hold the value. The size 
of the storage area must be — 

for a file number 1 word 

for an integer value 1 word 

for a short-precision value 2 words 

for a full-precision value 4 words 

for a string maximum length in bytes ^2-1-1 word 

(-i- 1 additional word if the maximum 

string length is odd) 

• An argument must have been passed by the ICALL (in the case of parameters) or a 
corresponding BASIC COM declaration must exist (in the case of common declarations). 

• The storage area must lie within the ICOM region. 
Calling Procedure: 

1. Load register A with the address of the storage area for the value. 

2. Load register B with the address of the parameter declaration. 

3. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

In the case that it is used to pass a string value, the Get_value utility returns the entire 
dimensioned string (which includes all characters between the current length and the dimen- 
sioned length of the string). 

Here is an example call to the utility, retrieving information from a fuD-precision argument — 



;!=;-; 4 
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UTILITY: Getclement 

General Procedure: This is similar to the "Get_value" utility. This utility retrieves a value 
from an element of an array passed as an argument. It works on arrays of any type. 

Special Requirements: 

• The storage area set aside for the value must be large enough to hold the value. The size 
of the storage area must be — 

for an integer 1 word 

for a short-precision value 2 words 

for a full-precision value 4 words 

for a string maximum length in bytes -^2 -I- 1 word 

(-1- 1 additional word if the maximum 

string length is odd) 

• The array information must be retrieved with the "Get_info" utility before calling this 
utility. 

• The offset of the element in the array must be correct in the array information (word 16 
returned by "Get_info"). It should be remembered that the offset of the element is 
dependent upon the number of dimensions in the array and the length of each. A calcula- 
tion may be necessary to arrive at the offset when accessing multiple-dimension arrays. 
The offset is in terms of number of elements.^ 

• The storage area must lie within the ICOM region. 

Calling Procedure: 

1. Store the element offset within the array information (word 16 returned by "Get-info"). 

2. Load register A with the address of the storage area for the value. 

3. Load register B with the address of word of the information returned by the "Get_ 
info" utility (see description of that utility). 

4. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

1 See the description of calculating array offsets under the "Get_info" utility. 
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Here is an example call, retrieving the third element (relative element 'I) of an integer array and 
placing it into Value — 






UTILITY: Getbytes 

General Procedure: This is similar to the "Get_value" utility. This utility retrieves a substring 
of a string passed as an argument, having been given the starting byte and the number of bytes 
to be retrieved. 

Special Requirements: 

• The storage area set aside for the substring must be large enough to hold all of the 
substring. This includes not only the string itself, but also two extra words. Remember, a 
word holds two characters. 

• A string must have been passed by the ICALL for the utility to work properly. 

• The storage area must lie within the ICOM region. 

Calling Procedure: 

1. Store the number of the starting byte of the substring desired into the first word of the 
storage area set aside for the substring. (Note that bytes and 1 are the length word of 
the string.) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Load register A with the address of the storage area. 

4. Load register B with the address of the parameter declaration. 

5. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. The substring is returned starting with the third word of the storage area. 
(Note: Since the second word contains the length of the substring, you have a string data 
structure starting with the second word!) 
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For example — 

I SOURCE Value' DBT 2 ! 1st character (ignore length.' 

ISaJRCE ESS 5 i Substring storage area 

In this example, Value is the storage area. Since 2 has already been generated and stored in the 
first word, and 10 in the second, the first 10 bytes of the string would be transferred. Of course, 
the original string must contain at least 10 characters — or the bytes which are returned may be 
nonsense. Why was the value 2 stored as the byte number? Because bytes in a string are 
numbered starting with 0, and bytes and 1 contain the length of the string (see "Data 
Structures" in Chapter 3). 



UTILITY: Getelembytes 

General Procedure: This is a combination of the "Get_element" and "Get_bytes" utilities. 
This utility retrieves a substring of an element of a string array passed as an argument. The 
utility is given the starting byte and the number of bytes to be retrieved. 

Special Requirements: 

• The storage area set aside for the substring must be large enough to hold all of it. This 
includes not only the string itself, but also two extra words. Remember, a word holds two 
characters. 

• The array information must be retrieved with the "Get_info" utility before calling this 
utility. 

• The offset of the element in the array must be correct in the array information (word 16 
returned by "Get_info"). It should be remembered that the offset of the element is 
dependent upon the number of dimensions in the array and the length of each. A calcula- 
tion may be necessary to arrive at the offset when accessing multiple-dimension arrays. 
The offset is in terms of number of elements.^ 

• The storage area must lie within the ICOM region. 



1 Sec the description of calculating array offsets under the "Get_info" utility. 
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Callin" Procedurs; 

1. Store the number of the starting byte of the substring desired into the first word of the 
storage area set aside for the substring. (Note that bytes and 1 are the length word of 
the string.) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Store the offset within the array information. 

4. Load register A with the address of the storage area for the value. 

5. Load register B with the address of word of the information returned by the "Get_ 
info" utility (see description of that utility). 

6. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. The substring is returned starting with the third word of the storage area. 
(Note: since the second word contains the length of the substring, you have a string data 
structure starting with the second word!) 

For example — 



-.v-L- ■ ZL- 



In this example, Value is the storage area. Since 2 has already been generated and stored in the 
first word, and 10 in the second, the first 10 bytes of the string element are transferred. Of 
course, the string element must contain at least 10 characters — or the bytes which are re- 
turned may be nonsense. 
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Changing the Value of an Argument 

At some point during the execution of your assembly language routine, you might want to 
accomplish the other half of this method of communication with BASIC — namely, changing 
the value of a BASIC variable which is used as an argument, in effect changing the value of a 
BASIC variable from the assembly language routine. 

As with retrieving a value, there are a number of utilities available for changing a value. The 
one to use is dependent upon the type of argument passed. The utilities available are — 





Name 


Used For 


Example Parameters 


Put_ 


value 


Simple variables, strings and individual elements 
of arrays passed as arguments 


Alpha,A$,B$(10),Array(2,3) 


Put_ 


element 


Elements (from arrays passed as arguments) 


Array(*),Z$(*) 


Put_ 


bytes 


Substrings of strings passed as arguments 
either as simple variables or as individual 
elements of arrays passed as arguments. 


String $,Z$(2,3) 


Put_ 


elem bytes 


Substrings of elements (from string arrays 
passed as arguments) 


Z$(*) 



Note that these utilities modify variables existing in the BASIC environment. They do not 
modify the length of the variables as dimensioned in BASIC. 

How each of these utilities is used is described in the immediately following pages. 

UTILITY: Putvalue 

General Procedure: The utility is given the address of the parameter declaration and the 
address of the value. It changes the value of the BASIC variable associated with the parameter. 
It works only on simple variables, expression strings, and individual elements of arrays (passed 
as arguments) of any type. 

Special Requirements: 

• The value must have the appropriate data structure for the data type of the argument (see 
"Data Structures" in Chapter 3). 

• An actual argument must have been passed by the ICALL for the utility to work properly. 



Calling Procedure: 

1. Load register A with the address of the storage area of the value. 

2. Load register B with the address of the parameter declaration. 

3. Call the utility. 
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following the call. 

Here is an example call to the utility, passing information to an integer argument — 



Here is an additional example demonstrating string passing - 



UTILITY: Putelcment 

General Procedure: This is similar to the "Put_value" utility. This utility changes the value 
of a single element in an array passed as an argument. It works on arrays of any type. 

Special Requirements: 

• The value must have the appropriate data structure for the data type of the argument (see 
"Data Structures" in Chapter 3). 

• The array information must be retrieved with the "Get_info" utility before calling this 
utility. 

• The offset of the element in the array must be correct in the array information for the array 
(word 16 returned by "Get_info"). It should be remembered that the relative element 
number of the element is dependent upon the number of dimensions in the array and the 
length of each. A calculation may be necessary to arrive at the offset when accessing 
multiple-dimension arrays. 

• The storage area must lie within the ICOM region. 



6-20 Communication Between BASIC and Assembly Language 



Calling Procedure: 

1. Store the element offset into the array information (word 16). 

2. Load register A with the address of the storage area for the value. 

3. Load register B with the address of word of the information returned by the 
"Get_info" utility (see description of that utility). 

4. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

Here is an example call, storing information from Value into element of an integer array — 



iSUUKLt 


V=L 1 u-- 1 


j-jys 


1 


I SOURCE 


Hf"-ra;,.' i nf'C 


: ; ESS 


39 


I SOURCE 


P 1 K-fui^-nt ; 


EQU 


Hrray i nfo+ 


I SOURCE 




SUE 




I SOURCE 


Pararnetpr: 


INT 


( * ) 


I SOURCE 




LDfl 


-firra-y info 


I SOURCE 




LDE 


= Pa ra meter ■ 


I SOURCE 




JSM 


Get._info 


I SOURCE 




LDR 


=0 



ISUUKCE 


S IH 


S='-=i 1 '. 


AS 


isnuRCE 


LDfl 


=S=a' 


\u 


I SOURCE 


LDE 


=Hri- 


~-zi 


I SOURCE 


JStI 


Put 


e 






UTILITY: Putbytes 

General Procedure: This is similar to the "Put_value" utility. This utility changes the value 
of a substring which is part of a string variable or an individual element of a string array, having 
been given the starting byte and the number of bytes to be changed as well as the new 
characters. 
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Special Requirments: 

• The bytes to be transferred are preceded by two words in the storage area. The two words 
contain the starting byte for the substring and the number of bytes to be transferred. 

• A string variable or an element of a string array must have been passed as an argument for 
the utility to work properly. 

Calling Procedure: 

1. Store the number of the starting byte of the substring to be changed into the first word of 
the storage area. (Note that bytes and 1 are the length word of the string) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Load register A with the address of the storage area. 

4. Load register B with the address of the parameter declaration. 

5. Call the utility. 

Exit Conditions: There are no error exits from the utility, so it always returns to the 
instruction following the call. 

For example — 



In this example, Value is the storage area containing the string to be transferred. Since 2 has 
already been generated and stored in the first word, and 10 in the second, the first 10 bytes of 
the string are changed. Why was the value 2 stored as the byte number? Because bytes in a 
string are numbered starting with 0, and bytes and 1 contain the length of the string (see 
"Data Structures" in Chapter 3). 
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UTILITY: Putelcmbytcs 

General Procedure: This is a combination of the "Put_element" and "Put_bytes" utilities. 
This utility changes a substring of an element in a string array which has been passed as an 
argument. The utility is given the starting byte and the number of bytes to be transferred. 

Special Requirements: 

• The bytes to be transferred are preceded by two words in the storage area. The two words 
contain the starting byte for the substring and the number of bytes to be transferred. 

• The array information for the array must be retrieved with the "Get_info" utility before 
calling this utility. 

• The offset of the element in the array must be correct in the array information for the array 
(word 16 returned by "Get_info"). It should be remembered that the offset of the 
element is dependent upon the number of dimensions in the array and the length of each. 
A calculation may be necessary to arrive at the offset when accessing multiple-dimension 
arrays. The offset is in terms of number of elements.^ 

Calling Procedure: 

1. Store the number of the starting byte of the substring to be changed into the first word of 
the storage area. (Note that bytes and 1 are the length word of the string.) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Store the element offset into the array information (word 16). 

4. Load register A with the address of the storage area for the string to be transferred. 

5. Load register B with the address of word of the information returned by the 
"Get_info" utility (see description of that utility). 

6. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 



1 See the description of calculating array offsets under the "Get_info" utility. 
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For pxamnlp — 



ISOURf 

isnuRC 

ISOURC 



I SOURCE 
I SOURCE 



LDfl 


=f\rra.y_J 


nfo 


LDB 


-Kar'arnet 


er 


JSM 


Get._infc 




LDfl 


=2 




STH 


El errient 




LDH 


=Value 




LDB 


=Hrray i 


nfo 


JSM 


Put el em 


bv 



nttss^t. t.i 



. 1 ready 



In this example, Value is the storage area for the string to be transferred. Since 2 has already 
been generated and stored in the first word, and 10 in the second, the first 10 bytes of the string 
element are changed. It is the responsibility of the software {not shown) to assure that 10 
characters of valid data are stored in the remainder of the storage area. 



Using Common 



A faster way to pass information between BASIC and assembly language routines is through 
BASIC'S common area. 

You may recall from subprograms in BASIC that if you have a COM statement in the main 
program, the locations named therein can be accessed by other BASIC subprograms and 
functions through their own COM statements. Though the subprograms may change the 
names, the locations are the same. The order of appearance in a COM statement is all- 
important. If a main program has the statement — 



rl, H 



and a subprogram has the statement — 



then X and A are the same storage location, B and Y are the same, and C and Z are the same. 
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The same kind of operation is available in your assembly language routines with the COM 
pseudo-instruction — 

COM 

As with the SUB pseudo-instruction, the COM only serves as a preface. It is followed by one or 
more parameter declarations of the same types as in the SUB — 

HNY 
INT 

tL 

HO 

TR 

The FIL is not permitted, since there is no corresponding item within BASIC'S COM syntax. 

Each pseudo-instruction used after an assembly language COM corresponds to an item in the 
COM declaration in the main BASIC program. Just as in a BASIC subprogram, the types must 
agree. ^ However, the ANY pseudo-instruction fulfills the same function here as it does with the 
SUB pseudo-instruction — to allow any type of item to be passed. 

As with SUB, arrays are designated by following the type with an array identifier — < * ■'. If the 
type is ANY, the array identifier is not allowed. 

Each pseudo-instruction reserves three words of memory when assembled. And, like SUB, the 
words are used to contain a descriptor. The descriptors are used by the variable retrieval 
utilities for fetching and storing values in the common area. The same utilities used in fetching 
and storing argument values are used for the same purposes for values in the common area. 
These utilities are — 

Get_info 

Get_value 

Get_element 

Get_bytes 

Get_elem_bytes 

Put_value 

Put_element 

Put_bytes 

Put_elem_bytes 

1 If the types do not correspond, an error results (number 198). This matching is checked only for the module containing the 
routine which was ICALLed. 
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The utilities are called in the same fashion and are subject to the same restrictions. See the 
description of the utilities in the preceding sections of this chapter to determine how they are 
used. 



The item pseudo-instructions used with the COM pseudo-instruction can have their own labels, 
just as the parameter declarations used with a SUB may have. And just as in a BASIC subprog- 
ram, they need not have the same names as were given the corresponding items in BASIC. For 
example, suppose the following BASIC common statement exists at the time of a call to an 
assembly language routine — 



xm 



k'y>,Z$ri0] 



then you could access Q(* ) and Z$ by using these pseudo-instructions 



isouRr 
isjiURi: 



REL 



I SOURCE V: STR 
Note the differences in names. 



If the number of item pseudo-instructions in the assembly language routine exceeds the 
number of items in common at the time the routine is called, an error results (number 199). 

Similar to BASIC, a common declaration can contain more than one COM sequence. All the 
COM sequences are treated together as a single common area. For example — 



BASIC: 
ASSEMBLY: 



!l If"! RtiHL. H : H 1 « IN 



:rir:.,U.i , i.> 



1 n ! 
INT 



NOTE 

If a BASIC COM statement is changed, modules containing 
the COM pseudo-instruction should be re-IASSEMBLEd or 
re-ILOADed before executing an ICALL statement. 
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Busy Bits 

Overlapped processing in the 9845 is partially implemented through the facility of "busy bits". 

Each variable located in the BASIC value or common areas has associated with it two bits which 
are independent of the value — a "read" busy bit, and a "write" busy bit. Each time an I/O 
operation is executed that cannot be buffered, one of the busy bits is set. If a variable is having 
its value changed by the I/O operation, then the read busy bit is set. If the variable is output- 
ting its value in the I/O operation, then its write busy bit is set. If a variable is not involved in a 
pending I/O operation both bits are cleared. When the I/O operation is completed, the busy 
bits for the variables involved are cleared. 

When an I/O operation is encountered during execution of BASIC statements, the appropriate 
busy bits are set and a request is made by the operating system for the resources to satisfy the 
operation. Until that operation is complete, BASIC (in OVERLAP mode), continues to execute 
succeeding lines in the program until it encounters a statement which contains variables with 
busy bits that are set. 

If the statement is attempting to use the value of a variable and its read busy bit is set, then the 
further execution of the statement waits until the busy bit is cleared. The same is true for a 
statement attempting to change the value of a variable when either its read or write busy bit is 
set. When the I/O operation completes, the busy bits are cleared and the waiting statement is 
executed. 

In short, overlapped processing uses busy bits as a signal as to whether a statement can be 
executed or not. 

If an ICALL statement is executed with overlapped processing, it is possible that a BASIC 
variable may be "busy" when the routine wants to access it. Although it is still possible to 
access the variable without regard to the status of the busy bits, frequently that is not a 
desirable programming approach. You may on occasion want to check the value of the busy 
bits when you suspect the user of the routine may be using overlapped processing. 

Busy bits are checked from an assembly program using the "Busy" utility to be described 
shortly. If you are checking the bits for a busy condition, and the busy- condition is set, it 
remains set throughout the time you are in the assembly routine. For it to become un-busy, you 
must give the operating system a chance to perform the I/O operation and clear the busy bits. 
One way to do this is to exit the ICALL and return to BASIC. 
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;-Jtf ILfli-i 

;di~i TP Pi 



If the Sort routine exits, setting Busy to if a busy condition is not encountered, and to 
non-zero otherwise, this keeps trying to execute Sort until the common variables which are 
busy become un-busy and it can proceed on its way. By exiting the routine after each unsuc- 
cessful attempt, the operating system is given an opportunity to perform the I/O operation 
which has the variable{s) tied up. 

uTiLiTY: Busy 

The Busy utility checks the status of the busy bits of a variable. 

General Procedure: The utility is given the location of the declaration for the variable. It 
returns the value of the busy bits for that variable into the A register. 

Special Requirements: This utility should be used for all variables involved in overlapped 
I/O operations. 

Calling Procedure: 

1. Load register B with the address of the pseudo-instruction of the declaration to be 
checked. 

2. Call the utility. 

Exit Conditions: The utility returns the busy bits in the A register. The "read" busy bit is in bit 
and the "write" busy bit is in bit 1. The other bits are cleared. 
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In the following example, if any of the busy bits among three common variables is set, a flag is 
set and the routine is exited — 



I SOURCE Var i ab 1 e 1 : I IH 
I SOURCE Variable2: SHO 
I SnURil:E Var i ab 1 e3 : REL 



JOURCE 

>OURCE Busy b' 

SOURCE Sort I 

500 RCE 

>OURCE 



SOURCE 
SaJRCE 
iOURCE 
SOURCE 

-=iJ-.f!^.V.C. 

OURCE 



LDE = Variable! 
JSM Busy 
RZfl l£_busy 
LDi! =Var1able2 

LDB = Var lab I e'i 
SZR Gq_ahead 
LDfl ==1 

LDB =Eusy__bit.s 
JSn Put value 



I 
ISOURC 



ahead" 






ISCliRCE Wcrk: ! Continue fiirocessing 

The overhead of exiting and re-entering the ICALL statement while waiting for a variable to 
become unbusy can be avoided. It is sufficient to allow the operating system to perform an I/O 
operation without having to go back to BASIC. A special utility, To_system, is provided for this 
purpose. 

UTILITY: Tosystem 

The To_system utility gives the operating system a chance to move toward completion of any 
I/O operation which has not already completed. 

General Procedure: Each call to the utility gives the operating system one chance to perform 
an I/O operation. 

Calling Procedure: Call the utility. 



Exit Conditions: The utility always returns the instruction following the JSM To_system in- 
struction. There are no error exits from the utility. 
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In the following example, the Sort routine waits until all busy bits in the three common vari- 
ables are cleared before proceeding with execution: 



I SOURCE 


Var- 1 : 


cun 
I HI 




I SOURCE 


Va.r2: 


SHO 




ISOURCE 


Var-3: 


KhL 




I SOURCE 




SUB 




ISOURCE 


Sort : 


LDB 


=Varl 


ISOURCE 




TQM 


Busy 


lyOURCE 
ISOURCE 




RZfl 
LDB 


Is busy 
^V^-2 ' 


ISOURCE 




JSn 


EUSM 


ISOURCE 




RZfl 


T-= hi 5-=i ■' 


ISOURCE 




LDB 


='./gr-3 ' 


I SOURCE 




JSM 


Busy 


ISOURCE 
ISOURCE 


Is_busy: 


SZH 
JSM 
Ji'lP 


Go ahe-ad 
Sort 


ISOURCE 


Go ahs-ad: 


I 





HI low system to do som 
■-•n€ck bijsy bits aqain = 
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7-1 



Chapter / 

I/O Handling 



Summary: This manual should be used in conjunction with "BASIC Language Inter- 
facing Concepts" which covers the specifics of different interface cards. This chapter 
describes the various techniques of handling the receiving and sending of information to 
peripheral devices. Topics are: a review of I/O machine instructions, registers, applica- 
ble utilities, interrupts and interrupt service routines, handshake I/O, direct memory 
access, and mass storage devices. 



A major usage for assembly language programs is to improve or customize the performance of 
the 9845 with respect to data transfers with peripheral devices. The types of devices dealt with 
are those which communicate via the various interface cards (e.g., HP 98032, HPIB, etc.). The 
types of I/O which the assembly language supports are programmed (handshake-type), inter- 
rupt, and direct memory access (or DMA). 

A number of detailed examples have been provided demonstrating the various types of I/O 
using different interfaces. These examples can be found in Appendix H. 



Peripheral-Processor Communication 

All I/O, except for that to the internal devices (tape cartridges, keyboard, printer, CRT, or 
Graphics), necessarily takes place through the "backplane". The backplane is that physical 
area of the machine where the interface cards are inserted (also known as the I/O "slots"). 



^ 



e 



G3 



h 



y 



Figure 8. Location of I/O Slots (Backplane) 
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Interfaces 



The processor does all its talking, through the backplane, to peripheral interfaces, never di- 
rectly to a peripheral itself. An interface is a complex electronic circuit which provides mechani- 
cal, electrical, data format, and timing compatibility between the 9845 and the peripheral 
device to which it is connected. From a programmer's point of view, the primary task of an 
interface is to provide a means of exchanging data between the 9845 and the peripheral. An 
interface isolates the programmer from the details of electronics and timing, appearing as a 
simple "black box" through which information is exchanged. 

The processor can talk to as many as 12 peripheral interfaces through the backplane. Each can 
be talked to individually, and there may be a mix of peripherals using programmed, interrupt, 
or D^4A types of transfers. 

Individual I/O operations (i.e., exchanges of single words) occur between the processor and 
one interface at a time, although interrupt and DMA modes of operation can be programmed to 
allow automatic interleaving of individual operations. 

A peripheral is addressed through a select code and a transfer occurs through four special 
registers reserved for the purpose. These will each be discussed shortly. 

Discussion of the techniques and methods presented in this chapter uses the common HP 
interfaces as examples. A full discussion of the operation of these interfaces can be found in the 
BASIC Language Interfacing Concepts manual (HP part number 09835-90600) and also from 
your Sales and Service office. 

Example programs utilizing various I/O techniques with a number of the standard interfaces 
can be found in Appendix H. 

Registers 

All I/O operations go through a set of four registers maintained by the 9845. The four registers 
named R4, R5, R6, and R7 are the sole means of communicating data between the processor 
and peripheral interfaces. While the registers are actually on the interface cards, they may be 
thought of as being in the computer memory. This makes the cards themselves accessible by 
simple memory referencing instructions. 

The 9845 sees the registers as single-words and always sends or receives a full word of data 
when it references one of them. If a particular interface utilizes less than the full sixteen bits 
(when exchanging 8-bit extended ASCII data bytes, for example), then the most significant bits 
(8 through 15) are received as zeroes. On output, if fewer than 16 bits are utilized by the 
interface, it ignores the most significant bits. The value of these bits, in this case, is a "don't 
care" (i.e., may be any pattern of ones or zeroes). 
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All of the HP 9803X series of interface cards use the registers as follows — 



Register 


On Input 


On Output 


R4 
R5 
R6 
R7 


Primary Data In 
Primary Status In 
Secondary Data In 
Secondary Status In 


Primary Data Out 
Primary Control Out 
Secondary Data Out 
Secondary Control Out 



The R4 register, then, is almost always used for data transfers. R5 is always used for status and 
control information. The "secondary" registers — R6 and R7 — perform the indicated func- 
tions only nominally. The exact interpretation as to how the register is used depends upon the 
interface card being used (see the BASIC Language Interfacing Concepts manual for details). 



In order to give some specific examples for using the registers, the 98032 16-Bit Parallel 
Interface (sometimes called General Purpose Input/Output — GPIO) is used. This card de- 
fines the secondary registers as — 



Register 


On Input 


On Output 


R41 


Low-Byte Data In 


High Bype Data Out 


R5 


Status In 


Control Out 


R61 


High-Byte Data In 


High-Byte Data Out 


R7 


(unused) 


Trigger 



Select Codes 

As mentioned earlier, more than one interface card may be connected to the 9845. It becomes 
necessary, then, that there be a mechanism whereby a particular interface can be chosen to 
respond when an I/O register is referenced for either input or output. This mechanism is the 
Peripheral Address Register (Pa). 

Pa holds a binary number in the range to 15 (utilizing only the lower four bits of the word, to 
3). Each interface has an externally-settable select code switch which can also be set to a value 
between and 15. However, since select codes 0, 13, 14 and 15 are reserved for the internal 
printer, Graphics and tape cartridge units, respectively, the permissible select code settings are 
1 through 12. 

Whenever an operation to one of the I/O registers is performed, the System 45 makes the 
contents of the Pa register available to all the interfaces connected to the backplane. Each card 
compares the value with its own select code. If they match, the interface responds to the 
operation. 



1 These registers contain the same data if the 98032 card is not jumpered for byte mode. See BASIC Language Interfacing 
Concepts. 
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So, for example, if the following statements are executed in turn — 

ISCilJRCE LDfl =8 ! Choose f:>triphera1 on select code 8 

I SOURCE STfl Pa 

ISuURCE LDfi R4 I Read froni the interface 

then a status byte is read from the interface card set to select code 8. 

The label "Pa" is reserved by the assembler for the Peripheral Address register. 

Status and Control Registers 

The primary purpose of any interface is to allow data to be exchanged between the computer 
and the peripheral device to which it is connected. But HP's 9803X series of interface cards are 
even more versatile, possessing a programmable capability of their own. This in turn provides 
optional capabilities with the card that can be set and changed by control instructions from the 
System 45. (For details on what capabilities are provided, consult the BASIC Language Inter- 
facing Concepts manual.) 

The programming of the interface is done by the 9845 using the R5 register. Some of the 
interfaces use other registers for extended control bits (these are also described in the BASIC 
Language Interfacing Concepts manual). 

Interface cards can also return information to the 9845 about which optional programming 
features are currently selected. This information, called the status byte, is obtained through an 
input operation using register R5. The status byte (8 bits) is determined solely by the charac- 
teristics of the interface card being addressed in the Pa register. (Again, information on particu- 
lar cards can be found in BASIC Language Interfacing Concepts). 

Remembering that these registers are not really memory locations, but instead are registers on 
the card being addressed by the Pa register, storing information to these locations is not the 
same as storing to other memory locations or registers. For example, storing a value in R5 to set 
the control register sends the information to the addressed interface. Later, if you were to read 
a value from R5, the information you sent would not be what is returned. Instead, the contents 
of the status register in the interface would be returned. 

Status and Flag Lines 

Whenever an I/O register is accessed, the interface with the same select code as is in the Pa 
register responds. The primary response depends upon the nature of the interface and which 
register is accessed (see discussion above). However, in all cases there is a secondary effect. 
Part of every interface's response is to set or clear the Status and Flag lines. 
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The Status line (not to be confused with the status register discussed above), is a single bit 
indicating whether the interface is operational or not. By inclusion, this can also mean the 
status of the actual peripheral to which the interface is connected. For example, if a peripheral 
device has a line coming from it that indicates its power is on, it could be connected to the 
Status line in the interface. Then the program could quickly determine whether the device is 
turned on or off. As another example, a printer might have the Status line connected to the 
out-of-paper indicator (should it have one) to indicate to the program when it is inoperable 
because of lack of paper. 

The Flag line is a momentary "busy /ready" indicator used to keep the computer from getting 
aiieat-i Oi tue peripnerai. i ne iine SnOws tuat tue interlace is busy processing tne last tasK given 
it by the 9845 or that it is ready for another operation. If the line is set, it indicates "ready"; if 
the line is cleared, it indicates "busy". For example, if the computer has a sequence of ASCII 
characters to send to a slow printer, it sends one character (making the Flag line "busy") and 
then waits for the Flag line to go "ready" again before sending the next character. 

There are four instructions, part of the I/O group, which can check these lines — 

SF"SSkip if Flag line is set (i.e., "ready") 
SF'CSkip if Flag line is cleared (i.e., "busy") 
SSSSkip if Status is set (i.e., "operational") 
SSCSkip if Status is cleared (i.e., "non-operational") 

These instructions have the capability of skipping up to 31 locations in a forward branch, up to 
32 locations in a backward branch, or to the same instruction. 
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Programmed I/O 



Programmed I/O is the process whereby software controls the transfer of information between 
memory and an interface. In the process the program must decide when and where to make the 
transfer, how to make it, and how much information to transfer. The decision even to originate 
the transfer comes under program control. 

The Status line can be used to determine the availability of an interface. The interface is 
selected, under program control, by the contents of the Pa register. Then the Status line is 
checked to see if the interface (and by inclusion its associated peripheral) is operational. 

After an operational interface has been chosen, the Flag line can be used to determine when 
the interface (i.e., peripheral) is ready for a transfer and when it has not finished with the 
previous transfer. 

With sufficient checks of Flag and Status before and between I/O operations, it is possible to 
eliminate initiating an I/O operation to an interface which isn't ready for it. The following 
example checks the status (status bit set) of an interface card: 



ISOURCt 
ISOURCf 



_IIH =] 



oi-fal , error 



BuURCE Stat 
BOURCE 
=;rii iRr:F 



it L 



i i4ai t. urrti 1 card 



The instruction sequence for a software controlled output transfer differs slightly from that of an 
input transfer. An output transfer involves waiting for the interface flag, outputting the data and 
then starting the output handshake. The following is an illustration of this sequence. The 
essential instructions are preceded by an asterisk in the comments column. 



ISOURi 

isouRi: 



H Ka 



aq Sh 
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An input transfer involves signalling an input operation, triggering the input handshake, waiting 
for the interface flag and then inputting the data. This sequence is illustrated here with the 
essential instructions preceded by asterisks in the comments column. 



jUKLL 










"iURCE 






Li'H 


Se 


lURCE 






STn 


Pa 


jURGE 


R 


q=L 1 n : 


sss 


*■!-; 


iiJRCE 






LBfl 


= lr 


jURGE 






JSM 


Pr-r 


iuRCE 






SFC 


* 


jiJRCE 






LDfl 


R4 


JURGE 






y 1 H 


R? 


iURGE 






SFG 


■s 


iURCE 






LDR 


R4 


JURGE 






JMp 


HyE 






jUKGL 



Interrupt I/O 



Interrupt I/O is a means of allowing control to pass temporarily to an assembly language 
routine other than the routine (BASIC or assembly language) currently executing. The "inter- 
rupt", which causes the control to be passed, is detected through the backplane and is as- 
sociated with a particular interface. After the "interrupt service" routine completes its tasks, 
control is passed back to the original routine. 

The process looks something like this — 



"original 
routine 



interrupt _]. 
detected I 
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The sequence of events in interrupt I/O can be detailed as follows — 

1. The interface sends a request for service to the backplane which passes it along to the 
processor. Conditions which generate this request for service are different for each I/O 
card. See BASIC Language Interfacing Concepts. 

2. The processor alters the flow of execution so that the routine associated with that inter- 
rupting source can be executed. The processor saves its place in the interrupted routine 
so that it can later return to it. The current contents of the Pa register are saved internally 
in the processor and the Pa is then set to the select code of the device causing the 
interrupt. 

3. The interrupt service routine is executed, performing whatever functions are desired. 
Frequently these functions involve some form of programmed I/O or direct memory 
access. The service routine may signal an end-of-line BASIC branch, indicating to 
BASIC that some condition occurred (discussed below). 

4. The service routine returns the processor to the interrupted routine so that the "original" 
process can resume. 

The uses for interrupt I/O are so diverse that it is difficult to generalize about them. However, 
one particular use is fairly well-defined and of general applicability — data transfers. 

Interrupt I/O is normally used in data transfers whenever a particular data device has a transfer 
rate which is significantly slower than that of the computer. Peripheral devices with transfer 
rates less than 7000 characters per second are candidates for interrupt I/O. 

The usual approach is to transfer a word to or from the peripheral device, then go away to do 
some other processing while waiting for the device to interrupt by becoming "ready" for 
another transfer. An example illustrating the general procedure for an interrupt I/O transfer is 
presented following some more background information concerning priorities, ISR linkage, 
access, preservation and indirect addressing. 



Priorities 

Select codes are assigned hardware "priority" levels to control what should be processed when 
an interrupt service routine is executing and another interrupt is received, or when two or more 
simultaneous interrupts are received. 
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Thsrs srs two priorit" Isvsls 

High for select codes 8 to 15 

Low for select codes to 7 

An interrupt received from a high-priority select code may interrupt a service routine which is 
executing for an interrupt from a low-priority select code. But an interrupt from a low-priority 
select code may not interrupt any other service routine. 

Interrupt Service Routines and Linkage 

An interrupt service routine is associated, or "linked", with a select code by the Isr_access 
utility described later. This linkage establishes where the interrupt service routine resides, and 
to which select code it applies. An interrupt service routine typically does one or more of the 
following — 

• Talks to the interface (i.e., satisfies or acknowledges the interface's interrupt). 

• Passes data to (or retrieves data from) the rest of the program, when appropriate. 

• Breaks the linkage, if desired. 

The method of talking to the interface depends upon the type of interface. Some devices or 
applications do not require the passage of data; the acknowledgement of the interrupt is usually 
the desired effect in such cases. 

Interrupt service routines are always exited with a RET 1 instruction. 

Breaking Interrupt Service Routine Linkage 

The interrupt service routine-select code linkage can be broken from within the interrupt 
service routine by executing one of two statements. If the linked select code is high priority, the 
statement is — 

JSM End_isr_high,I 

If the linked select code is low priority, the statement is — 

JSM End_isr_low,I 

After execution of one of these linkage-breaking statements, the interrupt service routine is 
exited with a RET 1 instruction. 
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Several important facts to keep in mind concerning the JSM End_isr_low,I and JSM End_ 
isr_high,I statements are the following: 

• The names, End_isr_low and End_isr_high, do not represent utilities or routines. There- 
fore, they should not be declared as externals. 

• Neither statement may appear outside of the appropriate interrupt service routine. 

• These linkage-breaking statements should only be executed inside the appropriate inter- 
rupt service routine when you no longer need select code linkage to the ISR. In most 
cases, this is when the ISR is no longer needed because the data transfer is complete. 

• The contents of the Pa register are used by End_isr_high and End_isr_low to determine 
what resources to free and what interrupt linkages to break. Upon entry to the ISR the Pa 
register contains the select code of the interrupting interface, but you can change Pa 
during execution of the ISR. If this is done, you must ensure that Pa is set to the desired 
value before calling End_isr_high or End_isr_low. 

Here is an example of a short interrupt service routine which simply reads and processes words 
from the interface and terminates when it encounters a linefeed. 



R4 I 



jjLr d^- i.ct 



ut. 1 r\f 



qqer ano^ 



ibr'l t.nd_iSr_ iOi..i 

?ET 1 ! Ret 



>-:iC k qrour'iu pruqrarri = 



FiHsTf:. 



NOTE 

Utilities cannot be called from an interrupt service routine. 
Attempts to do so lock up the machine. 



Access 

The operating system (OS) contains a mechanism to regulate requests for hardware capabilities 
in order to eliminate conflicting uses of these capabilities. For instance, since there is only one 
DMA^ channel, it is necessary that there be a mechanism to prohibit two simultaneous DMA 
transfers. 

1 DMA (Direct Memory Access) is explained further in later sections of this chapter. 
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The OS mechanism which regulates the use of DMA (and also interrupt) transfers either grants 
or does not grant what is called "access". Before starting either an interrupt or DMA operation, 
access should be requested from the operating system. 

Another example — suppose a device operating on a high priority select code has a relatively 
slow data rate. This is an ideal situation in which to use interrupt driven I/O. Suppose further 
that the device operates in such a fashion that the data must be transferred within a fixed time 
period following its issuance of an interrupt or the data is lost (the internal tape drive is such a 
device.) If there are other interrupt type transfers operating concurrently on other high priority 
select codes, it may not be possible to service our slow device within the necessary time frame. 

WVign tKig QTjorgtinn cuctom nranfc ;^rroQ<: thiQ tijnp nf C'^nflif't is imno<;.<;ihlp 

T*..W.> fc..W ^ ^^*->^>.*M M^ ^^^^^MMM ^^^^M*„%, -M^V^S^^, .....N,, -^ J^ ^ ^ »- -— J 

Users of the assembly language system are required to request access from the operating 
system. The OS grants access if granting this access does not compromise any previously 
granted access. 

Devices such as that discussed above which require interrupt service within a specified time 
frame are called "synchronous", and should use "synchronous" access. Devices with no such 
time constraints are called "asynchronous", and should use "asynchronous" access. 

Abortive access is intended to be used by routines that will be executed only extremely in- 
frequently. For instance, if the System 45 is monitoring a potentially dangerous manufacturing 
process, it may be necessary to have an interrupt service routine to shut down the process when 
something goes awry. This could be accomplished with an abortive routine. The advantages of 
access code (abortive access) is that no other modes of access are prohibited by its use. Thus, 
the infrequently used routine will not prevent another routine from getting the type of access it 
needs. 

Access code should be used with caution. An interrupt routine with abortive access can exist 
on the same priority level as an interrupt routine with synchronous access. If the abortive 
routine is in progress when an interrupt occurs requiring the synchronous routine, the abortive 
routine will finish before the synchronous routine can be serviced. The timing requirements of 
the sychronous routine might thus be violated. 

Access code is also used to release access in a particular type of DMA transfer to be explained 
later in this chapter. 
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The regulation of access incorporates the following points — 

• When the operating system grants synchronous access to an operation, it is guaranteeing 
that the requesting process will have its interrupts serviced with maximum priority. 

• DMA conflicts with synchronous access since DMA's cycle stealing causes the processor to 
run slower and could thus compromise a synchronous process. 

• Synchronous access on a low priority select code conflicts with asynchronous access on a 
high priority select code since the asynchronous device could interrupt the synchronous 
ISR, thus compromising the timing requirements of the synchronous device. Synchronous 
access conflicts with asynchronous access on the same priority level. Remember an inter- 
rupt request on the same priority level as a currently executing ISR will not be processed 
until the executing ISR completes. 

The following table summarizes the granting of access — 

Access Already Granted 

Abortive ASYN DMA SYN 
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BASIC statements also obtain and release access as I/O is performed. The following table lists 
some of the ways access is used by the system — 



Use 


Access 


Cartridge Operations 


SYNC (HIGH select code) 


Flexible Disk Operations 


DMA 


PRINT, PRINT USING 


ASYNC 


Plotter Drivers 


ASYNC 


CARD ENABLE 


ASYNC 


ENTER /OUTPUT INT 


ASYNC 


ENTER/ OUTPUT DMA 


DMA 


ENTER/OUTPUT FHS^ 


DMA 



In general, single BASIC statements could cause access to be granted and released several 
times. For example, the cartridge operations obtain and release synchronous access once for 
each physical record transferred. 

It is imperative that access be released after an interrupt service routine has been executed for 
the last time or a DMA transfer is complete. Such occurrences as tape drive lockout, can occur if 
access is not released. Use the JSM End_isr_high,I or JSM End_isr_low,I instructions to free 
access, depending on the select code used. 

UTILITY: Isr_access 

This utility is used to request access and, if the access is granted, to create the linkage between 
an interrupt service routine (ISR) and a select code. Valid select codes are 1 through 13. 
Pressing RESET ( UttroiJ ^stopj ) during execution of the utility may cause a SCRATCH A to be 
issued. 

General Procedure: The utility is told where the ISR resides and what kind of access is 
required. If access is granted, it returns successfully. If access is not granted immediately, it 
keeps trying periodically until it is successful or until a specified number of attempts have been 
made (in which case it returns unsuccessfully). 



1 In addition to obtaining DMA access (which in this case is used just to ensure there is no synchronous access granted), theFHS 
(Fast Handshake) drivers disable all interrupts during the actual transfer loop. 
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Special Requirements: The B register must contain information as follows 



15 


14 


13 


12 


11 


10 


9 
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6 


5 


4 
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Bits 



0-3 
4-5 
8-14 



Description 



Select code to be linked to the ISR 

Access code 

Number of attempts to be made before aborting 



The access codes are — 

Abortive access 

1 Asynchronous access 

2 DMA with asynchronous access 

3 Synchronous access 

Calling Procedure: 

1. Load register A with the address of the ISR. 

2. Load register B with the information described above. 

3. Call the utility. 

Exit Conditions: 

RET 2 If the attempt at linkage is successful, the utility returns to the second word following 
its call. Register Pa is set to the select code; if access code 2 was specified then 
Dmapa has also been set to the select code. 

RET 1 If the attempt at linkage is unsuccessful, the utility returns to the first word following 
the call. Register A contains an indication of the type of difficulty encountered — 

— 1 Access couldn't be obtained after specified number of attempts. 



2 Select code is still linked to an assembly language ISR. 
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As an example of the use of the Isr access utility, suppose an ISR is to be linked to select code 
2 for asynchronous access. The following would be a sequence to establish such a linkage — 



JURCE LDfl =R. 

JURCE LDE -<A 

OURCE 



Jbl'i 


isr 


"' ■=!. 


Jilr 


Er-h 


-•or 


1'— 


R 




JMP 


Nei 


■ le> 


JHP 


Ho 


re: 



ISOURUL jPlr Ntsted Tsr ! Handler for yu bi 



NOTE 

Access must be released after the execution of an interrupt or 
DMA transfer is complete with a JSM End_isr_high,I or a 
JSM End_isr_low,I instruction, depending on the select 
code used. 

Disabling Interrupts 

At times it is necessary to disable all interrupts in order to execute a particular sequence of 
instructions. This is typically necessary for one of two reasons: 

• The instructions are modifying some data used by an ISR, and the ISR would become 
confused if it happened to occur when this data was in a transitory state. 

• All ISRs are prohibited in order to minimize the execution time for some task (i.e. fast 
handshake transfers). 

In general, it is allowable to disable interrupts (using the DIR instruction) for up to 100 ^ts 
without "notifying" the operating system. (Interrupts are re-enabled using the EIR instruction.) 
Attempts to disable for more than 100/x.s without this notice could compromise any synchron- 
ous transfers that may be in progress. Specifically, it could cause loss of data if a tape operation 
were in progress. 

If is necessary to disable interrupts for more than 100/as, the Isr_access utility should be used to 
acquire an access which ensures that no synchronous transfers are jeopardized. Typical access 
code requests to do this are DMA, ASYNC HIGH, or SYNC (high or low). The one to choose 
depends on the application. 
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For example, suppose you would like to minimize the execution time for a segment of code. 
The segment takes longer than IOO/as, but you need to disable interrupts for the duration. The 
ideal access to request may be DMA. Once DMA has been granted there can be no DMA 
transfers (which might slow the processor) and there can be no synchronous transfers in 
progress. Therefore, interrupts can be disabled for as long as necessary. 

When Isr_access is used for this purpose (i.e. to get access rather than to set-up ISR linkages), 
the entry and exit conditions are as previously described except that the A register must contain 
a zero. 

When access is obtained in this manner, it is freed by calling Isr_access a second time with the 
A register containing a zero. However, the access code requested in bits 4 and 5 of the B 
register must be zero. This technique of freeing access can be used only if the original access 
was granted without interrupt linkage (i.e. the A register was 0). Attempts to do otherwise cause 
Isr_access to give the fail return (RET 1). 

The following example illustrates the technique for a fast handshake transfer to a 98032 
interface on select code 6. 
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State Preservation and Restoration 

When an interrupt is detected and an interrupt service routine is called, the operating system 
automatically saves the state of some of the registers so that their values can be restored upon 
return from the ISR. Other registers are left alone and if your service routine uses them, it is up 
to your ISR to save them and restore them before returning from the ISR. 

The registers which are automatically preserved are — 



A 

B 

C 

Cb 

P 

Pa 



Also, the state of the Overflow and Extend processor flags are preserved and restored before 
the return from the interrupt. 

The D and Db registers are not automatically saved. Saving and restoring location Db is not 
trivial due to the fact that this location is a read-only location. The following program segment 
saves and restores D and Db: 



Sir L 
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If your ISR contains any of the following types of instructions — 

Indirect addressing 
Stack group 
CLR 
XFR 

and the operand of the instruction(s) is an address in the ICOM region, then it is necessary that 
the following instruction sequence be executed in the ISR before any such instruction is 
executed — 



LDH 35 E 
STH Sav^ 
LIiH 34 E 
STH 35E 



Then, before the ISR exits, and after the affected instructions have been executed, the 
following sequence must be executed — 



LDH £^ye3^:^ioi...i 
BTH 35 E 



Indirect Addressing in ISRs 

Indirect addressing in ISRs can produce anomalies unless the following rules are followed — 

1. If indirect addressing is employed with the operand being an address in the ICOM 
region, one of the processor registers must be preserved. For the method of doing this, 
consult the "State Preservation and Restoration" section immediately above. 

2. If indirect addressing is used in a JMP or JSM (including any jumps to external symbols 
or symbols more than 512 words away from the current instruction, both of which have 
implied indirect addressing), then the most significant bit must be set in the address. For 
example, instead of — 

e>-;t Sub 



JSM Sub 
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in an ISR tht; procedure must be — 



FxT 



JSM (=Sub+i0000yB>, I 

The assembler can generate an indirect instruction when you have not specified a ,1 after the 
instruction. These indirect instructions lock the machine if executed within an ISR, and 
therefore must be re-written. lOF (indirect off) and ION (indirect on) are used to find those 
instructions for which the indirection is done automatically by the assembly. At the beginning of 
ISR use the lOF instruction. At the end of ISR use the ION instruction to restore the assembler 
to its normal state. Between an lOF/ION pair, any instruction for which the assembler would 
have generated an automatic indirect, a range error (RN) is generated. 



Enabling the Interface Card 

The particular interface card that you are using must be enabled for interrupts. The 98032 
Interface card is used for illustration purposes. Setting bit 7 of the R5 OUT register enables this 
particular card for interrupts. The R5 OUT register is represented here — 

98032 — R5 Register 



Bit? 


Bit 6 


Bits 


Bit 4 


Bits 


Bit 2 


Bitl 


BitO 


ENABLE 
INT 


ENABLE 
DMA 


RESET 


ENABLE 
AUTO 
HAND- 
SHAKE 


X 


X 


CTLl 


CTLO 



t7 

t6 

t5 

t4 

t3 

t2 

tl: 

tO: 



Logical 1 enables card to interrupt 
Logical 1 enables DMA 
Logical 1 resets interface card 
Logical 1 enables auto handshake 
(Don't card) 
(Don't card) 

Optional peripheral control bit 1 
Optional peripheral control bit 



Control bits and 1 are used to drive interface lines CTLO and CTLl, respectively. CTLO and 
CTLl are optional peripheral control lines. 

(Representations of the I/O registers for each interface are provided in the Assembly 
Language Quick Reference manual.) 
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The 98032 card is enabled for interrupts with the instructions 



Dh ~" 200E 



and disabled with — 



The interface card is typically enabled for the first data transfer, disabled at the beginning of the 
ISR and re-enabled before the ISR is exited. 

Interrupt Transfer Example 

An example of setting up an interrupt service routine for inputting character data is given in the 
example below. This example should bring together the information presented in the previous 
five sections of this manual. Note the procedures for requesting and giving up access, enabling 
and disabling the interface card for interrupts and processor register preservation and 
restoration because of indirect addressing in the ISR. 
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Direct Memory Access 



lemory 
(DMA) 



Direct memory access (DMA) is a means to exchange entire blocks of data between memory 
and peripherals. A block is a series of consecutive memory locations. Once started, the process 
is automatic; it is done under processor control, regulated by the interface. Since only the 
98032 Interface supports DMA, the following discussion is in terms of that interface. 



To the peripheral, the DMA operation appears as programmed I/O. The transfer, however, is 
actually performed by special DMA hardware. Information regarding the transfer is stored in 
the DMA registers for the DMA hardware to use. This information is the select code, the initial 
memory location, and the number of words to be transferred. The memory location register 
and the count register are successively adjusted after each word transferred until the transfer is 
complete. Upon completion of the transfer, the interface and the DMA hardware stop 
automatically. 

The direction of the transfer is specified before the transfer takes place. It can be specified as 
either "inward" (i.e., from the peripheral to memory), or "outward" (i.e., from the memory to 
the peripheral). To set the direction outwards, the instruction — 



inr 



is used. To set the direction inwards, the instruction — 



is used. 

DMA Registers 

There are three registers which contain information used by the DMA hardware — Dmapa, 
Dmama, and Dmac. Before any DMA transfer takes place, the appropriate values must be 
loaded into these registers. 

Dmapa contains the peripheral address of the device requesting DMA. Only the least 
significant bits of the register specify the select code which is to be the peripheral side of the 
DMA activity. During DMA transfers, the address bus takes its address from the Dmapa register 
rather than Pa as in other I/O transfers. The value is supplied to Dmapa by the Isr_access 
utility when it grants DMA access. 
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Dmama contains the address of the first word in memory (i.e., lowest address) where the data 
transferred is (or will be) stored. After each word transferred, this register is automatically 
incremented. Note that the entire block to be transferred must reside within the ICOM region. 

Dmac is the count register for a DMA transfer. Before the transfer begins, it should be set to 
n-1, where n is the number of words to be transferred. After each word transfer, the count is 
decremented. If, during a word transfer, the value of Dmac is (meaning that this is the last 
word to be transferred), the processor automatically informs the interface that the DMA 
operation will be complete after the present word is transferred. 

DMA Transfers 

There are two techinques for using DMA. Both initiate the DMA transfer in a similar manner but 
differ in how the end of the transfer is detected. The more commonly used method uses an 
interrupt generated by the interface. The second method uses a programmed test. 

DMA transfers using interrupt are initiated with a sequence of six distinct actions. 

Step 1: The Isr_access utility is used to obtain access to the DMA channel and to set up the 
ISR linkage used when the transfer terminates. 

Step 2: The direction is set for input using an SDI instruction or for output using an SDO 
instruction. 

Step 3: The appropriate values are stored into the Dmama and Dmac registers. (Dmapa is set 
by the Isr_access. ) 

Step 4: For input, the first handshake is initiated with these instructions: 



For output, this step is deleted. 

Step 5: The interface is enabled for DMA and interrupt by setting bits 4, 6, and 7 of R5 OUT to 
one. (i.e. 320B^R5) 

Step 6: The DMA requests are enabled using the instruction DMA. 
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At this point you can do other processing if desired since data is being transferred automatically 
by the hardware. When all words have been transferred the interface interrupts the processor, 
causing the previously linked ISR to be executed. This ISR should: 

• Disable the interface (bits 4, 6, and 7 of R5 OUT set to 0). 

• Free the DMA acces by using End_isr_high or End_isr_low. 

The following is a program segment to input 1024 words of data into an internal buffer area 
using interrupt to terminate the transfer. 
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In the previous example, the end of the DMA transfer is signaled by an interrupt which causes 
execution of an ISR. The ISR, in turn, gives up the DMA access and terminates the ISR linkage 
with End isr low, I or End isr high, I. 
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DMA transfers without interrupt are initiated with a sequence of six steps. 

• Isr_access is used to obtain the DMA channel, but not to set-up an ISR (A register has a 
value). 

• The direction is set for input using an SDI instruction or for output using an SDO 
instruction. 

• The appropriate values are stored in Dmac and Dmama. 

• For input, the first handshake is initiated with these instructions: 



• The interface is enabled for DMA by setting bits 4 and 6 of R5 OUT (i.e. 120B-^R5). 

• The DMA requests are enabled using the instruction DMA. 

At this point you can do other processing if desired since data is being transferred automatically 
by the hardware. To determine if the transfer is complete, the Dmac register is tested. If it is 
negative, the transfer is complete and you should: 

• Disable the interface (bits 4, 6 and 7 of R5 OUT set to 0). 

• Free the DMA access by using Isr_access with the A register containing a and an access 
code of 0. 

The following is a program segment to output 1024 words of data from an interrupt buffer area 
without using interrupt to terminate the DMA. 
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BASIC Branching on Interrupts 

The handling of interrupts can be integrated into BASIC programs by using the ON INT 
statement. The object is to allow the flexibility of combining the high-level features of BASIC 
with the capabilities of assembly language in asynchronous I/O applications. And since ISRs 
cannot use the system utilities, in particular those that access a BASIC variable, a means of 
taking action on an interrupt after completion of the ISR is a necessity. 



ON INT Statement 

The ON INT statement is an executable BASIC statement which acts in a similar fashion to the 
ON KEY statement (see the System 45 Operating and Programming Manual). The statement 
allows the BASIC programmer to specify where, in his BASIC program, to branch whenever an 
End-of-line branch is signalled for the select code he specifies. 

As with the ON KEY statement, there are three ways these branches can be taken — 

# {select code} [== {priority} ]_-._. {subprogram name} 

# {select code} [, {priority} ] " _ t i {line identifier} 

# {select code} [= {priority} ] :_ . {line identifier} 

Whenever an interrupt is signalled from an ISR for a particular select code, if ON INT has been 
executed for that select code, then at the end of execution of the BASIC line which was 
executing when the signal came, the indicated branch in the ON INT is taken. 

In the GOTO version, the branch is "absolute", which is to say that the program goes to the 
line indicated and picks up its execution there, forgetting where it was before. This has the 
effect of an "abortive" type of branch, and should only be used by the BASIC programmer 
when he wants the program to resume execution at some pre-determined point after handling 
an interrupt, without regard to where the program was before the interrupt occurred. 

In the CALL and GOSUB versions, the branch is only temporary. After the subprogram or 
subroutine has been executed and the SUBEXIT, SUBEND, or RETURN (as appropriate) has 
been executed, then the program returns to the line following the one where it was interrupted. 
This is the same as if the CALL or GOSUB was in between the interrupted line and the one 
following it. 

The {line identifier} and {subprogram name} in the CALL, GOSUB, and GOTO statements are 
the same as elsewhere in BASIC, except that a CALL may not have any parameters. 
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The {select code} specified in an ON INT statement restricts the branching action to occurring 
only when the assembly language triggers the ON INT condition for that select code. The 
interrupt may have occurred in actuality on another select code. This can be a way of allowing 
more than one branch for interrupts from a single interrupting device. 

As an example — 

100 ON IHT#3 GOSUE Print_resu]t. 
110 ON INT#5 GOSUE End ^iata 



Should an interrupt occur anywhere in the program, causing an assembly language interrupt 
service routine to be executed, that assembly language ISR has the capability to cause either 
the branch of line 100 or the branch of line 110 to be taken. Thus, an assembly language ISR 
signals BASIC either to print an intermediate result or to note that all data has been processed. 



Signalling 

The {select code} specified in an ON INT statement restricts the branching action to occurring 
only when a branch is "signalled" for that select code. In actuality, an interrupt may not have 
occurred on that select code at all. Conversely, an interrupt may occur on the select code, but 
BASIC and its ON INT condition may never hear about it. It is necessary for the ISR which does 
the actual handling of an interrupt to inform, or "signal", the operating system that the inter- 
rupt occurred and trigger the ON INT conditions which may be set up at the time. 

The responsibility of the ISR to signal the ON INT is also an opportunity. This signalling allows 
you in an ISR to decide whether or not you want BASIC to know about the interrupt. If you do 
not want BASIC to know, simply do not signal the condition. The signalling also allows you to 
signal different interrupt conditions. An example of doing this might be a case where, after an 
interrupt, a peripheral indicates whether it wants to input or output data. Your routine could 
signal one select code to execute an input routine and signal another select code to execute an 
output routine. 

To signal an ON INT, your ISR must execute the following instructions — 



SOURCE 


LDE Isr ps 


BOURCE 


LDH =103E 


30URCE 


STR E, I 


BOURCE 


flriE-3 


BOURCE 


LDH Mask 


BOURCE 


STH E, I 



q^■^a 
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Mask necessarily contains the select code to be signalled. Rather than containing the number of 
the select code, however, it has the bit set for the appropriate select code. For example, if you 
are signalling select code 2, you set bit 2 to 1 in Mask and leave the others 0. Similarly, if you 
are signalling select code 5, you set bit 5. Thus, the statement containing Mask in the above 
could just as easily be a literal. For example — 



would signal select code 5. 

If the select code is not known at assembly time or if the ISR is shared by more than one select 
code, the following segment of code can be used to build the appropriate mask. (Pa cannot be 
zero, because zero is not a valid select code for the Isr access utility.) 



HDH 



When you want to signal a select code after others have already been signalled, a slightly 
different instruction sequence is required — 



I SOURCE 


LDB Isr p 


I SOURCE 


LDH =i03E 


I SOURCE 


STH E,I 


I SOURCE 


HIJE^S 


I SOURCE 


LDH rfesk 


I SOURCE 


DIR 


I SOURCE 


lOR E,I 


I SOURCE 


STH E, I 


I SOURCE 


EIR 



•lect. coH? 



Mask is the same as above. 
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As a further example, suppose you want both to signal BASIC when a device sends a line-feed 
character to the computer, and to terminate the ISR's linkage. Then the ISR might appear as — 



jUR( 



I SOURCE 


I sr- : 


LDR 










I SOURCE 




CPR 


= Lt' 








I SOURCE 




.JMP 


Tt-rT!iinat.e 








I SOURCE 




STfl 


R7 








I SOURCE 




RET 


i 








I SOURCE 


Ter-ff 


irs-ateMSM 


End i sr h 


qh,I 






I SOURCE 




LDE 


Isr psw 




! 3 i gi-"ta 1 


BRSIC 


I SOURCE 




LDH 


= 103E 








I SOURCE 




3TH 


B,I 








I SOURCE 




HliE 


=3 








I SOU ROE 




LDH 


~~ i 




! SiqnEil 


'■'■ i nput 


I SOURCE 




SIR 


E, I 








I SOURCE 




RET 


1 




! Returr 


to ERS 



Prioritizing ON INT Branches 

Since more than one interrupt may occur while a single BASIC statement is executing, it is 
possible that by the time the line finishes there may be a number of ON INT branches waiting to 
be executed. In such situations you may want to assure that some ON INT branches are taken 
before others, or that you finish one routine (caused by an ON INT GOSUB or ON INT CALL) 
before you start another. This can be achieved by using the {priority} option of the ON INT 
statement, thereby "prioritizing" the branching caused by interrupts.^ 

There is a "system priority" for ordering this interrupt branching. For an ON INT to be honored 
at the end of a BASIC line, its priority must be greater than the current system priority. 

Initially, the system priority is set to 0. When a BASIC line finishes, and there is at least one ON 
INT branch pending which is greater than the system priority, then the system takes the branch 
associated with the ON INT with the greatest {priority}. The values assigned to {priority} may be 
any integer numeric expression from 1 to 15. If {priority} is omitted, 1 is assumed. 

If the ON INT branch to be executed is a GOTO, then the system priority level is unchanged. 
But if the branch to be executed is a GOSUB or a CALL, then the system priority level is 
changed to the priority level of the ON INT. Whenever the subroutine or subprogram is finished 
executing, then the previous system priority level is restored. 



1 This "prioritizing" also holds between the various types of end-of-line branch statements that have the priority parameter. 
Thus an ON KEY with high priority is executed before an ON INT with low priority. 
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Thus with ths GOSvJB uwd ilAT T v'8rSiO"S t^SrS SrS tW^ offon^c ir\\jr\\\jir\r\ nri/^irj+ioc 

• The subroutine or subprogram is not allowed to execute until its priority is the highest one 
pending. 

• Whenever the subroutine or subprogram is executing, it locks out any other interrupting 
branches unless they have a higher priority. 

With the GOTO version there are also two effects, slightly differing — 

• The branch is not taken until it has the highest priority of all pending branches. 

• The execution of the branch does not lock out any other branches, so that at the end of 
the line to which it branches, if there are other pending branches, the highest one of those 
is executed. 

For example, suppose there are these four statements in effect — 



■1 1 NT 


#4, i 


bO i U Rout i ne 4 


: T i. • — 

i 1 li 1 


m, 9 


GOSUE Rout i ne_j5 


■■1 INT 


#6, 5 


GOTO 1000 


••i INT 


#7. i: 


:i GOSUB Routine 



and also suppose that at the end of some BASIC line in the program, an interrupt had been 
received from all four of the interfaces involved. Then the process of dealing with them pro- 
ceeds like this — 



EVENT 


NEXT ACTION 


SYSTEM PRIORITY 


Reaches end of current 
BASIC line 


GOSUB Routine_7 


Changes from to 15 


Finishes Routine 7 


GOSUB Routine_5 


Changes from 15 to 9 



Suppose at this point another interrupt is received from select code 7. 



EVENT 


NEXT ACTION 


SYSTEM PRIORITY 


Reaches end of current 
BASIC line in Routine 5 


GOSUB Routine_7 


Changes from 9 to 15 


Finishes Routine 7 


Returns to interrupted 
point in Routine_5 


Changes from 15 to 9 


Finishes Routine 5 


GOTO 1000 


Changes from 9 to 


Finishes with line 1000 


GOTO Routine_4 


Stays at 
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Environmental Considerations 

Changes in program environment (i.e., calling a subprogram or returning from one) can affect 
whether an ON INT is in effect or not. 

Once executed, the CALL version of an ON INT is always in effect, if it is in the main program, 
until it is redefined by another ON INT or is specifically disabled (see below). 

In the GOSUB or GOTO versions, the statement is in effect only in the same program environ- 
ment. This is to say that if you have executed an ON INT statement in your main program, then 
it is effective only while your program is executing part of the main program. The instant the 
program goes into a subprogram (through a CALL statement), the statement is no longer 
effective until the execution returns to the main program. Similarly, if you define an ON INT in 
a subprogram, it is effective only while the program is executing that subprogram. 

A side-effect occurs here when you use the CALL version of an ON INT. By calling the 
subprogram with an ON INT, you have the effect of locking out the other interrupts, except 
those which are executed in the subprogram itself and other CALL versions. This is regardless 
of priority. In the priority example in the previous section, if the ON INT#5 had been a CALL 
instead of a GOSUB, then the second interrupt from select code 7 would not have been 
acknowledged until the subprogram had finished. 

Since recursive calls of subprograms are possible, it is also possible that many calls to the same 
subprogram may be stacked up because an interrupt from a different select code with a CALL 
version of an ON INT in effect may be received while processing the CALL caused by a 
previous interrupt. 



Disabling ON INT Branching 

The branching enabled by an ON INT statement can be disabled using an OFF INT statement 
for the same select code. It is effective for the ON INT statement within the same program 
environment (main program or subprogram) or for the CALL versions of the ON INT within any 
environment. 

The statement has the form — 

Qpp jNT # {select code} 

where {select code} is a numeric expression for any valid interface select code between 1 and 
13, inclusive. 
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The effect of the OFF INT statement is to disable the ON INT for that select code within the 
current environment. If there is no ON INT statement currently in effect for the select code, 
then the OFF INT has no effect. 

The DISABLE and ENABLE statements work the same way for the ON INT statements as they 
do for the ON KEY statements. They should not be confused with the DIR and EIR machine 
instructions, which disable and enable the interrupt system. 



Mass Storage Activities 



For devices meeting the operating system's criteria for mass storage peripherals, utilities arc 
provided for the reading and writing of records. The relationship between physical, logical, and 
defined records is discussed later in this chapter. 

If a device has been specified in a MASS STORAGE IS statement in BASIC, as in — 

ilRSS STuRnGE IS ^^:F^^ 



or is capable of being so specified, then it is possible to use utilities to access it. Note that the 
Mass Storage ROM is necessary to access any device other than the internal tape drive(s). 



NOTE 

BUFFER# must not be used with files which are accessed 
using these utilities. 

There are two utilities involved in reading from a mass storage device — Mm_read_start and 
Mm_read_xfer — and there are two utilities involved in writing to a mass storage device — 
Mm_write_start and Mm_write_test. The reading utilities are always used together. So, too, 
are the writing utilities. 

Reading from Mass Storage 

The flow of data to and from a mass storage device is buffered. For each device there is a 
"device buffer" in memory which holds data corresponding to a physical record (256 bytes). 
Device buffers are dynamically allocated by the operating system and their actual locations at 
any given time are of no concern. 
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To get information from a mass storage device into its device buffer, use the Mm_read_start 
utility. Then to get the information out of the buffer and into your user space, use the 
Mm_read_xfer utility. The transfer of data, therefore, looks something like this — 



Mass f 


^ [ 

Mm - read - start / 


Device 
Buffer 


/ Mm - read - xfer 


User 
Space 


Storage T 


/ 


/ 



The utilities accomplish their purposes with the help of two locations containing vital 
information for their use. The first is the Mass Storage Descriptor (MSD) and the second is the 
Mass Storage Transfer Identifier (MSTID). 

The MSD is three words in the ICOM region which contains the following information — 



WORD 



MSUS 


1 


lower 1 6 bits of 
record number 


2 


don't 
care 


upper 7 bits of 
record number 



15... 7 6 



This information must be provided by your program. You must determine this information in 
advance of attempting the reading operation. The msus is given in one of two forms — 



Unit 
Number^ 


HPIB 
Address 


Device 
Type^ 


Select 
Code 


1 1 1 
1 1 1 


1 1 
1 1 


1 1 1 1 
1 1 1 1 


1 1 1 
1 1 1 



15 14 13 12 11 10 9 



7 6 5 4 3 2 1 Bit 



or 





Unit 
Number 


Device 
Type^ 


Select 
Code 


1 1 1 
1 1 1 


1 1 
1 1 


1 1 1 1 
1 1 1 1 


1 1 1 
1 1 1 



1514131211 10 9 8 7 6 5 4 3 2 1 OBit 

for the 9885MS Flexible Disk Drive. 

If the MSUS word contains a -1, the mass storage device indicated by the MASS STORAGE IS 
statement is used. The instructions — 



lIH 



H !■- 



1 The device type is the ASCII code for the type minus lOOB. 

2 For tape operations, bits 9-15 are zeroes. 
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specify the default mass storage device. 

The MSTID is a single word. The information in it is returned by the Mm_read_start utility and 
used by the Mm_read_xfer utility. 

The usual procedure in reading a record from mass storage (which is all that can be read at one 
time) is to call the Mm_read_start utility and then, if all goes well with that, to call the 
Mm_read_xfer utility. Because the latter utility may have to wait on the operating system or 
the device, it is possible the utility may return without having completed the transfer. In that 
case, it is your option either to loop back and keep trying, or to do something else and try again 
later. 

UTILITY: Mmreadstart 

General Procedure: The record number is determined, then the transfer of the record's 
contents is made from the device to the device buffer. If the buffer allocation causes a memory 
overflow, there is an error. 

Special Requirements: The record number and msus must be loaded into the MSD in 
advance of the call. There must be a stable location (not changed by other activities) for the 
MSTID to be held. 

Calling Procedure: 

1. Store the msus and record number into the MSD area. 

2. Load register A with the address of the MSD area. 

3. Call the utility. 

Exit Conditions: 

RET 1 Occurs if there is a memory overflow during execution of the utility. 

RET 2 Occurs if all went normally. Register A contains the MSTID. This should be 
immediately stored in the location reserved for it. 

UTILITY: Mmreadxfer 

General Procedure: The MSTID is used to retrieve the record from the device buffer. The 
record is stored into a location set aside for this purpose. 

Special Requirements: The MSTID must be available from a previous call to 
Mm_read_start. A location of 128 consecutive words must be set aside to hold the contents of 
the record when they are returned by the utility. 
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Calling Procedure: 

1. Load register A with the contents of the MSTID. 

2. Load register B with the address of the storage location for the data. 

3. Call the utility. The transfer may not be completed on the first or subsequent calls (see 
exit conditions). In that case, to successfully complete the transfer, all three steps must 
be repeated. 

Exit Conditions: 

RET 1 Occurs when the transfer is not completed. It is up to your routine at this point to 
decide whether another attempt should be made immediately, or whether 
something else should be executed (and to come back later). 

RET 2 Occurs when the transfer is complete. The location specified contains the data. If 
register A contains a non-zero value, an error occurred and A contains the error 
number. In addition to mass storage errors (80 through 99), error 19 is returned if 
the MSTID parameter is invalid. 



CAUTION 

PRESSING RESET (QQ) DURING EXECUTION OF 
EITHER OF THE ABOVE UTILITIES MAY CAUSE A 
SCRATCH A TO OCCUR. 



The following is an example of a typical call to these utilities to read a record from mass 
storage — 



SOURCE Number 
JOURCE Nsd: 
mjURCE Mstid: 
iOURCE Recorc 



OURCE 
OURCt 
OURCE 
OURCE 
OURCE 
OURCE 
OURCE 
SOURCE 
I SOURCE 



LiiR =((-T-100B>*16 + 14> ! MSUS for ^^:Ti4^' 

STfl Msd ! Creat-e the MSD 

LDR Number i Store low-order bits 

STfl Msd+i 

LDfl Hurnber+i ! Store high-order bits 

STfl Msd+2 

EDH =Msd 

JSN Nm_rsa^j_start ! From device to buffer 

JMP Memor'...' overf 1 Oi...i 



• e c o r d n u \n u t f'' 



jrd number- 
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loiJJRi 



'z' i H 


Nst. i d 


_Dh 


M d t -i H 


LLE 


=Recor-d 


jrip 


FeTch 


3ZH 


*+2 


jsn 


Error e 



•j.-t r 
I r:h^-rL- 



record to iCuM buff 



Writing to Mass Storage 

Writing to mass storage is very much like reading from it. The flow of data is buffered. To get 
the data from the user space into the device buffer, and then to transfer the data from the buffer 
to the mass storage device, the Mm_write_start utility is used. Then a test can be made to 
determine when the transfer is complete by using the Mm_write_test utility. Thus, the transfer 
looks like — 



1 Mm write test 



Mass 
Storage 



Mm write start 



Device 
Buffer 



'Mm write start 




As with the reading utilities, these utilities accomplish their purposes with the help of the same 
two locations — MSD and MSTID. They contain the same information as they do in the reading 
utilities and are used in a similar fashion. 

UTILITY: Mmwritestart 

General Procedure: The record number is determined, then the transfer of the data is made 
from the ICOM region to the device buffer. If the buffer allocation causes a memory overflow, 
there is an error. 

Special Requirements: The record number and msus must be loaded into the MSD in ad- 
vance of the call. There must be a stable location (not changed by other activities) for the 
MSTID to be held. The data to be transferred must be ready (256 bytes — 128 consecutive 
words). 

Calling Procedure: 



1. Store the data to be transferred in its location. Store the msus and record number into 
the MSD area. 

2. Load register A with the address of the MSD area. 

3. Load register B with the address of the data location. 

4. Call the utility. 
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Exit Conditions: 

RET 1 Occurs if there is a memory overflow during execution of the utility. 

RET 2 Occurs if all went normally. Register A contains the MSTID. This should be im- 
mediately stored in the location reserved for it. 

UTILITY: Mmwritetest 

General Procedure: The MSTID is used to check to see if the data from the buffer has been 
transferred to the mass storage device. 

Special Requirements: The MSTID must be available from a previous call to Mm_write_ 
start. 

Calling Procedure: 

1. Load register A with the contents of the MSTID. 

2. Call the utility. The transfer may not be completed on the first or subsequent calls (see 
exit conditions). In that case, to successfully test for a completed transfer, both steps in 
the calling procedure must be repeated. 

Exit Conditions: 

RET 1 Occurs when the transfer from the device buffer to the device is not completed. It is 
up to your routine at this point to decide whether another test should be made 
immediately, or whether something else should be executed (and to come back 
later). 

RET 2 Occurs when the transfer is complete. If register A contains a non-zero value, an 
error occurred and A contains the error number. In addition to mass storage errors 
(80 through 99), error 19 is returned if the MSTID parameter is invalid. 



CAUTION 

PRESSING RESET (QQ) DURING EXECUTION OF 
EITHER OF THE ABOVE UTILITIES MAY CAUSE A 
SCRATCH A TO OCCUR. 
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The following is an example of a typical call to these utilities to write a record to mass storage — 



ISuURiJt Number" BSy 2 



ISOURCE LHH =0; ■"■T-i08E>*16 + 14 ! NSUS for ^■:T14^' 

I SOURCE SIR Msd i Create the MSD 

ISOURCE LDfl Humber \ Store 1 ou^order bits of re 

ISOURCE STh iisd+1 

ISOURCE LDH HuiYiber-i-l ■ Store hiqh-order bits of r 

ISOURCE STH nsd+2 

Tgnnprc LDE =Pi^cord 

ISOURCE JSM riri!_write_start ! Put record in buffer 

ISOURCE JriP Meriior|,.;_oyerf loi.i 

ISOURCE STfl ristid ! Keep the MSTID 

ISOURCE Test: LBH Mstid 

ISOURCE JSM Mrii_i..ir 1 te_test ! Is transfer of data cornp 

ISOURCE JMP Test ! Hot completed 

ISOURCE SZH *+2 ! Check for errors 



System File Information 

As an ASSIGN statement is executed in BASIC, a file-descriptor is created for that assignment 

in the operating system's files table. The ASSIGN statement essentially has two parameters — 

the file number and the file name (including the BASIC language mass storage unit specifier). 

The file number is, for all practical purposes, an offset into the files table. The file name and the 
BASIC language mass storage unit specifier are translated and the critical information as- 
sociated with them comprise an entry in the files table (i.e., the "file descriptor"). 
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The file descriptor consists of 10 words containing the following information — 



Word 



Description 



Lower 16 bits of the address of the first physical record in the file 
Number of defined records in the file 
BASIC'S Current defined record number 

(i.e., an offset from the file's beginning). 
BASIC'S offset to current word within current 

defined record 
Size of the defined record (in words) 
Mass storage unit specifier (msus) 
BUFFER# flag (0 = no BUFFER# active)^ 
Check read status (0 = off, 1 = on) 
Highest 7 bits of the first physical record in the file 
(Reserved by the operating system) 



Note that words 5, and 8 contain the information necessary to create an MSD. You may 
access a file descriptor through two utilities — Get_fiIe_info to obtain the information, and 
Put file info to change the information. 



NOTE 

A files table is created for each BASIC "environment" (i.e., 
main program and subprograms). When access is made 
through utilities to the files table, the table accessed is the 
one associated with the BASIC environment which called the 
assembly language program. 

UTILITY: Getfileinfo 

General Procedure: The utility is given the file number and the location of a place to store the 
file descriptor. It retrieves the designated descriptor and stores it, provided the file has been 
assigned. 



1 If this flag is non-zero, it indicates that a BUFFER# is active for this file. Therefore, Mass Storage utilities should no be used. 
Executing another ASSIGN statement for this file clears the BUFFER* flag. 
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fingcial Rgiuirsinsntsr Thsrs must bs a tsn-vvord arsa availabls for ths utility to stors ths 
information from the descriptor. 

Call Procedure: 

1. Load register A with the address of the ten-word area where you desire the information 
to be stored. 

2. Load register B with the file number (an integer from 1 to 10). 

3. Call the utility. 

Exit Conditions: 

RET 1 Occurs if the file is not currently assigned by a BASIC ASSIGN statement. 

RET 2 Occurs if all went normally. 

Here is an example of a routine which has a file number passed to it, and then gets the file 
descriptor — 



lU 



I SOURCE 










SUE 




I SOURCE 


h 


B.f 


"■ar 


itter : 


FIL 




I SOURCE 


P 


Qi 


a. 


ne : 


LDH 


=File 


I SOURCE 










LDB 


=Par-amete 


I SOU ROE 










jsn 


Get- ■■.■'•al ue 


I SOURCE 










Thip 


=FiTe des 


I SOURCE 










LIiE 


File 


I SOURCE 










JSH 


Get f 1 1 e 


I SOURCE 










JMP 


Ho file i 



5t.nr 1 Gf^t. f i 1p df 



qned 



UTILITY: Put file info 



General Procedure: The utility is given the file number and the location of the area contain- 
ing the new file descriptor information. It stores that information into the files table as indicated 
by the file number, provided that the file has been assigned. 
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Special Requirements: The new pointer information must be stored in the designated area 
before calling the utility. This information must be in the correct form and location or file 
difficulties may ensue. Most of the information is normally returned by the "Get_file_info" 
utility and only a couple of words are changed to change the pointer in the file (e.g., the current 
record and word numbers). Only words 2, 3, and 7 should be changed in the descriptor. 

Calling Procedure: 

1. Load register A with the address of the ten- word area where the information is stored. 

2. Load register B with the file number (an integer from 1 to 10). 

3. Call the utility. 

Exit Conditions: 

RET 1 Occurs if the file has not been assigned by a BASIC ASSIGN statement. 
RET 2 Occurs if all went normally. 

Here is an example where the next defined record in a file is specified — 

File: ESS 1 ! File number 

File dtscriptor: ESS 10 ! File inf orrri.3.t. i on 



ISZ Fi l6__desrript.or+2 i Increfnent re 

LDR -y 

STH Ft ]t_descript.or+3 ! Set ioord to 

LDH =File_descriptor 

LDB F n e 

JSM Put file info 

JP1P No file error I File not assiqn 



Communication with BASIC Data Files 

It is perfectly acceptable and practical for assembly language programs to write data patterns to 
data files and read them back. This has the advantages of simplicity and efficiency. However, 
such files cannot be properly read by the BASIC READ# statement or written for assembly 
routine use by the BASIC PRINT# statement. Therefore, if it is necessary for an assembly 
language program to read or write data which is contipatible with READ# and PRINT#, the 
assembly language program must recognize and conform to the conventions used by these two 
BASIC statements. This section discusses these conventions. 
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Interrelation of Record Types 

Recall from the System 45 Operating and Programming manual that there are three types of 
records used with the System. 45 as follows: 

• Physical record - 256-byte, fixed units which are established when a mass storage 
medium is initialized. Every file starts at the beginning of a physical record. 

• Defined record - established using the CREATE statement. Defined records can be 
specified to contain any number of bytes in the range 4 to 32 767 (rounded up to an even 
number). The first defined record of a file starts at the beginning of a physical record. 

• Logical record — a collection of data items that are grouped together conceptually. Dif- 
ferent logical records may have different lengths within the same file. If a logical record is 
not immediately followed by another logical record and does not end on a defined record 
boundary, it is followed by either an EOR (end of record) or EOF (end of file) mark. 

In order to locate logical records within a file, it is necessary to know the relationship between 
logical and defined records. This relationship depends on the method of file access used to 
write the information into the file. When a file is written using strictly serial file access, the first 
logical record starts at the beginning of the first physical record, the second logical record starts 
immediately after the first logical record and so on. Logical records may cross defined record 
boundaries. When a file is written using strictly random file access, each logical record starts at 
the beginning of a defined record and is contained entirely within the defined record. A hybrid 
method is also possible. With this method, logical records are written starting at the beginning 
of defined records other than the first one, and the logical records may cross defined record 
boundaries. Logical records may start immediately after other logical records, as well as at the 
beginning of defined records. Illustrations representing files produced by each of the three 
methods described above are presented here — 



Defined Record 



Defined Record 



Defined Record 



Defined Record 



n — \ 

Logical Record — *4-< — t Logical Record 



-»4-«- 



Logical Record 



-H 



File produced by serial access. 



1 






1 


1 

-* — Logical Record — >A 


1 
-♦Logical Record-H 








1 






1 



File produced by random access. 
I 





1 1 


-< — Logical Record — H 

1 






1 1 



File produced by hybrid access. 
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The READ# and PRINT# statements read and write logical records which may be optionally 
positioned on defined record boundaries. Physical records are essentially invisible to the 
BASIC user. On the other hand, the assembly language mass memory utilities deal with physi- 
cal records. To keep the relationship between defined and physical records simple, it is recom- 
mended that data files be created with 256 bytes per defined record (this is the default byte per 
record number used by the CREATE statement when the record length argument is not 
supplied). When 256 byte records are used, physical and defined records are identical. If you 
choose not to use 256 bytes per defined record, the relationship between physical and defined 
records is also fairly simple if the number of bytes per defined record is a power of 2 (e.g., 64) 
or is an integer multiple of 256 (e.g., 768). 

Crossing Record Boundaries 

The subject of what happens when a logical record crosses a physical and defined record 
boundary is now considered. The sequence of data words is not affected as the physical record 
boundary is crossed. For example, suppose there are three words remaining in a physical 
record and the next data item to be written is a real number (which requires four words). The 
first three words are written at the end of the current physical record and the last word is written 
at the beginning of the next physical record. 

However, the same is not true when a sequence of data words crosses a defined record 
boundary. Numeric data items are not allowed to cross defined record boundaries. When 
writing a data item, the follow three cases exist: 

• If there are enough words left in the current defined record to contain the item, the item is 
written in that record. 

• If there are no words left in the current defined record, the item is written at the beginning 
of the next record. 

• If there are one or more words left in the current record but not enough to hold the data 
item, an end of record mark is written immediately after the previous data item in the 
current record and the new data item is written at the beginning of the next record. 

Of course, these cases apply when physical record boundaries coincide with defined record 
boundaries. A fourth case exits and involves an attempt to write a full -precision number into a 
file with 4 or 6 byte defined records or to write a string into a file with 4 byte defined records. If 
either operation is attempted, ERROR 61 results. 

Strings may cross defined record boundaries but special rules apply in this case. These rules are 
described later when string data types are discussed. 
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A full-precision number exits in a data file as four words in a form tha looks like this — 



15 14 13 12 11 10 



Bit 



Exponent- 
Sign 

IVlost- 
Significant 
Digit 





1 1 ! i 1 ! 1 t 

Exponent 


I i F ! 

110 1 




D1 


D2 


D3 


D4 


D5 


D6 


D7 


D8 


D9 


Dio 


Dii 


Dl2 "*" 



Mantissa 
Sign 



• Least 
Significant 
Digit 



This is the same format as that shown in Chapter 3, except for the type bits which are used to 
identify the number as full precision. A full-precision number must have the type bits set to the 
pattern 01101 when written to a mass storage device, otherwise READ# will not interpret the 
data correctly. A full-precision number must have its type bits cleared before it is used with the 
math utilities or sent back to BASIC. Erroneous results occur if the type bits are not cleared. A 
full-precision number must not cross a defined record boundary. 

A short-precision number exists in a data file as two words in the following form: 



15 14 13 12 11 10 



Bit 



Exponent- 
Sign 



- 


1 1 1 1 1 

Exponent 


i 


II 1 

Di 


1 1 1 

Da 


D3 


D4 / 


D5 


D6 



IVIantissa Sign 



This is exactly the same as the usual short-precision format. READ# identifies short-precision 
numbers by the fact that Di and D2 are valid BCD digits. A short-precision number must not 
cross a defined record boundary. 

An integer precision number exits in a data file as two words in the following form — 



15 


14 


13 


12 


11 


10 


9 


8 7 


6 


5 


4 


3 


2 


1 








"I 




1 









1 







1 1 




1 




1 







1 

1 


1 




1 


1 




Integer 



Bit 



Type Word 



The first word is a type word which allows READ# to identify the data as an integer. The 
second word is the integer value in the usual two's complement form. An integer precision 
number must not cross a defined record boundary. 
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Strings are stored in data files in various forms, depending on how many defined record 
boundaries are crossed. The simplest case occurs when the string fits entirely within the current 
defined record. The fundamental format is illustrated here — 



0000000000111 


1 


n(Length) 


Bytel 


Byte 2 


1 '^ 


Byte n 









Type Word 
Length Word 



When the string does not fit entirely within on record, it is stored as a "first part" , zero or more 
"middle parts" and a "last part". The following illustration represents a 300-byte string which 
has been written into 256-byte records starting at the third-to-last word of the record. 



Defined 
Record ■— 
Boundary 



Defined 
Record — 
Boundary 



(Previous data item) 



0000000000011100 



300io 



Bytel 



Byte 2 



000 0000000001100 



29810 



Byte 3 



Byte 5 



Byte 4 



Byte 6 



Byte 253 



Byte 254 



000000000010110 



46io 



Byte 255 



Byte 256 



Byte 299 



Byte 300 



(Next data item, EOR or EOF) 



Type Word (First Part) 
Length Word 

Type Word (Middle Part) 
Length Word 



Type Word (Last Part) 
Length Word 



Note the different type words for the various parts. Also note that the length words contain the 
total number of bytes remaining in the string. 
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Strings are written according to the following rules: 

1. If defined records are only 4 bytes long, then ERROR 61 results. 

2. If the string fits entirely within the current record, the entire string is written into that 
record. (Null strings fall under this rule if there are at least 2 words available). 

3. If there are 1 or 2 words left in the current record, an end-of -record mark is written after 
the previous data item. If there are 0, 1 or 2 words left in the current defined record 
(before an EOR was written), then the data file pointer is moved to the beginning of the 
next defined record and the string is then written starting in the new current record as in 
Step 2 above. 

4. Otherwise, as much of the string as will fit in the current record is written as a first part 
string. Zero or more middle parts are written, one per defined record, and then the last 
part string is written. 

File Marks 

End-of-record (EOR) and end-of-file (EOF) marks exists as single word markers as shown 
below. 



15 14 13 12 11 10 



1 Bit 


















'o 


'o'o' 'o' 





1 


1 

1 


1 

1 


1 


1 



15 


14 


13 


12 


11 


10 


End-of-record Mark 
9 8 7 6 


5 


4 


3 


2 


1 




















1 




1 1 1 1 1 




1 


1 


• 1 


1 

1 


1 


'o 



End-of-file Mark 



An EOR indicates that there is no more valid data in the current defined record. If a serial 
READ# tries to read more data when the file pointer is positioned at an end-of-record mark or 
positioned past the end of the defined record, the READ# skips to the beginning of the next 
defined record and tries to read data there. 



An EOF indicates an end of data. If a READ# tries to read more data when the file pointer is 
positioned at an end-of-file mark or past the end of the last defined record, then an ERROR 59 
results unless there is an ON END# condition active for that file pointer. 
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For best results when writing data files, write EOR and EOF marks according to the following 
rules: 

1. Write EOR marks as indicated in the discussion of string data files, given in the previous 
section and according to the rules outlined in the section "Crossing Record Bound- 
aries". If these rules are not followed, the BASIC READ# statement will attempt to 
interpret the unused words at the end of defined records and will probably give ERROR 
65, incorrect data type. 

2. In a serial access file, write an EOF immediately after the last logical record. If there is no 
room in that record for the EOF mark, write the EOF at the beginning of the next defined 
record. If this is not done, you may not know where your data ends when you try to read 
it later. If another logical record is to be appended to the end of the previous data, the 
first word of the new data must overwrite the previous EOF. If there is no space in that 
record for an actual data item, the EOF must at least be replaced with an EOR. 

3. If random access is used to find the end of data in a serial file, be sure that there is an 
EOF at the beginning of all unused defined records. 

4. A defined record in a random access file can be made empty by writing an EOF at the 
beginning of that record. 

5. The nature of programs that use random access is such that they usually do not try to 
read more data than was written. But for safety sake, it is a good idea to write an EOF or 
EOR after each logical record in a random access file, if there is room in each defined 
record. 

Determining Data Types 

The type of data item in a data file can be determined by ANDing the first word of the data item 
with 76B. The result (the type bits) can be used in conjunction with the following table to 
determine the data type: 



Type Bits' 


Data Type 


12B 


Integer number 


32B 


Full-precision number 


14B 


Middle part of a string 


348 


First part of a string 


548 


Last part of a string 


748 


Total string 


368 


EOR 


768 


EOF 


Other 


If the right byte consists of two valid BCD digits 




the data type is a short-precision number. 



1 The remaining codes have not yet been assigned but are reserved. 
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Printing 

Three utilities are provided to enable you to gain access to the standard system printer: 
Printer_select, Print_string and Print_no_lf. An additional utility, To_system, allows you to 
expedite the printing process. 

UTILITY: Printerselect 

Background Information: Printer_select allows you to set the standard system printer to a 
select code of your choosing. 

General Procedure: The utility is given the select code to be assigned as the standard system 
printer and the desired printing width. The utility makes the assignment and returns with the 
previous values of both the select code and printer width. 

Special Requirements: The select code value must be in the range of through 18 for the 
utility to work properly. The select code and associated device for committed printer select 
codes are as follows: 

- internal printer 

16 — CRT alpha raster 

17 - display line of the CRT (as used for the DISP instruction) 

18 — system message line of the CRT (as used for system error messages) 

HP-IB devices are not allowed for use with the Printer_select utility. 
Calling Procedure: 

1. Load register A with the desired select code. 

2. Load register B with the desired printer width. 

3. Call the utility. 

Exit Conditions: There are no error exits from the utility, so it always returns to the instruc- 
tion following the call. Register A contains the value of the previous select, and register B 
contains the value of the previous printer width. 
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The utility can feasibly be used just to interrogate the current value of the printer's select code. 
However, a second call to the utility is needed in such cases to assure that the select is not 
changed by the first call. So, for example — 






This results in an unchanged printer specification and the values for the select code and width 
being stored in the ICOM area for future use. 

Because of the possibility that a RESET ( ^ontwiJ ^stopJ ) ^ or similar interruption, may occur between 
the first and second calls to the utility, it is recommended that the first call have a definite valid 
value for the select code in A (as above). In that way, should there indeed be an interruption, a 
valid select code for the printer can be assured. 

UTILITY: Printstring 

Background Information: Print_string allows you to print a string to the standard system 
printer. A carriage-return line-feed sequence is sent following the string. 

General Procedure: The utility is given the address of a string, and it prints that string to the 
standard system printer. 

Special Requirements: The string to be printed must be in standard string format (see "Data 
Structures" in Chapter 3). The string must be no longer than 506 characters. 

Calling Procedure: 

1. Load register A with the address of the string to be printed. 

2. Call the utility. 

Exit Conditions: 

RET 1 If a memory overflow occurs during execution of the utility. 
RET 2 If the (^ key is pressed during execution of the utility. 
RET 3 If all goes normally. 
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T-nr ovamnlo 



or 



The DAT statement and the location counter (*) can be used to calculate string length so that 
strings can be modified without having to constantly specify length. The following example 
illustrates this useful feature: 






The strings in this example can be modified to any length less than 507 characters. The number 
of characters need not be placed in the DAT statement as this is taken care of in lines 30 
through 50 and 60 through 80. 
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CAUTION 

PRESSING RESET QQ) DURING EXECUTION OF 
THE PRINT_STRING UTILITY OR THE PRINT_NO_LF 
MAY CAUSE A SCRATCH A TO OCCUR. 



UTILITY: Printno If 

Background Information: Print_no_lf operates in an identical fashion to the Print_string 
utility except that no carriage-return line-feed sequence is appended to the end of the string. 
This is analogous to using PRINT (<print list>;) in BASIC. 

Genera! Procedure: The utility is given the address of a string, and it prints that string to the 
standard system printer. 

Special Requirements: The string to be printed must be in standard string format (see "Data 
Structures" in Chapter 3). The string must be no longer than 506 characters. 

Calling Procedure: 

1. Load register A with the address of the string to be printed. 

2. Call the utility. 

Exit Conditions: 

RET 1 If a memory overflow occurs during execution of the utility. 
RET 2 If the [^ key is pressed during execution of the utility. 
RET 3 If all goes normally. 
For example — 



ijURr 
SOURi 
URi 
URC 



LEifl ==27, ^'MESShGE #1 IS CONCHTEHflThD 

JSM F'''"'if'it_nc>_i f 

JMP U'...'prf 1 oui i Over-flow routine. 

JMP Stopkev ! Stop key pressed. 



ISuURCE LDR ==14, ''iO MtSSRbt #; 
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I SOURCE JSM Pririt._string 

I SOURCE JMP Overf ioi..i ' ! Ouerf low routii 

I SOURCE JMP Stopkey ! Stop key press 

ISOURCE HOP ! Nornsal e;<it.. 



The result that is sent to the standard printer is — 
MESSAGE# 1 IS CONCATENATED TO MESSAGE #2. 



The Beep Signal 



An audible tone (beep) can be produced from assembly language programs by storing 
lOOOOOB into R7 while Pa=0. This procedure can be used in interrupt service routines as well 
as in background programs. Here is an example — 



ISOURCh LDE h'a i o-aue old t'\ 

ISOURCE Llifl =0 

ISOURCE STH Pa ! Clear Pa. 

ISOURCE LDH =1000006 



bUURUfc. 



r.eep 



SOURCE STE Pa I Res- 



Expediting I/O 



The design of the System 45 operating system is such that an assembly language routine can be 
executing while there is one or more I/O operations pending or "queued up" by the system. 
This condition may arise when BASIC statements such as PRINT, OUTPUT, ENTER, PLOT, 
I ASSEMBLE and others are executed in OVERLAP mode before an ICALL statement or when 
utilities such as Print_string or Print_no_lf initiate I/O from within the assembly language 
module itself. The operating system doesn't get a chance to move these I/O operations toward 
completion as long as the assembly routine is executing. 

This fact is typically of little concern since the operating system resumes its attempt to complete 
the I/O operation as soon as the ICALL completes. However, there are three specific cases in 
which expedition of an I/O operation is useful or even necessary. These three cases follow: 

1. when the assembly routine is waiting for a busy variable to become not busy. 

2. when the assembly routine takes a long time to execute and the programmer wishes to 
continue working on queued up I/O. 
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3. when the assembly routine needs to guarantee that I/O to a particular select code has 
completed. 

Case 1 has been discussed in Chapter 6. Case 2 can be taken care of by including an occas- 
sional JSM To_system in a long assembly routine. The third case might arise in situations 
where the routine must make sure that a message is printed on the CRT before starting a long 
computation process. This situation might also arise when the assembly routine must com- 
municate with an I/O interface card which may be involved in an OVERLAPPED I/O opera- 
tion. Consider the following example: 



PRINTER IS 6 








PRINT LIH'::3>, 


"HI 


THE 


Rh" 


I CALL Mine 








ISOURCE 






SUE 


I SOURCE Mine: 






LDH =6 


ISOURCE 






STF! Pa 


ISOURCE 






LDH =1 


ISOURCE 






STH R5 



If this segment of code is executed in SERIAL, the ICALL would not begin until the PRINT is 
completed and there is no problem. If, however, the segment is executed in OVERLAP, the 
ICALL is allowed to begin, even though the operating system has not yet completed the 
PRINT. The results of this kind of situation are unpredictable. 

A technique called "flushing" is used to ensure that all I/O operations on a particular select 
code have completed. The process of flushing involves interrogating a special table within the 
operating system to determine if an I/O operation is pending on a particular select code. The 
following routine flushes all I/O from the select code passed in the A register. 



OURCE Flush_poiunt.er: ESS 1 

SOURCE Flush_io: SflL 1 ! Compute offset into table 

OURCE hDR =1770006 ! Compute pointer into tabl^ 

OURCE STfl Flush_po inter 

SOURCE Flu£i-!_loop: LDH Flush_pointer, I ! Is select code busy 

>OURCE SZfl Flush__done ! Yes. 

SOURCE JSM T<:;_system 

=OURCE JMP Flu3h_1oop 

JOURCE Flush done: RET 1 



The flushing technique should not be used in the following two cases: 

1. Mass memory devices: Use the mass memory utilities to communicate with mass mem- 
ory devices. 

2. The Isr_access utility: It automatically flushes the select code of all activity. 
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Chapter O 

Debugging 



Summary: This chapter describes techniques for isolating and correcting logic prob- 
lems in assembly programs. Included in the discussion are techniques for stepping 
through programs, getting dumps, patching, and using the keyboard. 

The assembly system has provided you with a number of BASIC language tools to help you 
debug your assembly language programs during their development stages. 

These tools are for run-time debugging, so your source code must have been assembled into 
object code and stored in the ICOM region before attempting to use any of the debugging 
features detailed in this chapter. 

There are three classes into which these tools fall: stepping through programs, dumps, and 
value checking. There is also an additional capability provided for the correction of som.e 
errors — patching. 

The BASIC statements available for debugging are — 






and the following BASIC functions are available — 
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Symbolic Debugging 



Many statements allow symbolic addressing. The general rules are — 

An {address} or {assembled location} can have two forms — 

{symbol} [ , {numeric expression} ] 
{expression} [ , {numeric expression} ] 

where, 

{symbol} is an assembly location. It may be either a label for a particular machine instruc- 
tion, an assembler-defined symbol or a symbol defined by an EQU instruction. 

{expression} may be a numeric or string expression. Variables in expressions are assumed 
to be BASIC variables. If numeric, a decimal calculation is done and the result is inter- 
preted as an octal value; an error results if the result is not an octal representation of an 
integer. If a string expression is used, the string must be interpretablc as either an octal 
integer constant or a known assembly symbol. 

{numeric expression} serves as a decimal offset from the given label or constant. Vari- 
ables in these expressions are assumed to be BASIC variables. An undefined BASIC 
variable is always given the value 0. 
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Stepping Through Programs 

"Logic" difficulties are some of the hardest problems to solve in debugging programs. In batch 
environments, the usual solution is to print the contents of variables at critical points in the 
program or to print dumps. The capabilities for both of these methods are provided. However, 
advantage has been taken of the interactive, "hands-on" nature of the 9845 and a feature has 
been added which allows you to execute the assembly statements individually. This permits 
you to examine the flow of the program as it executes rather than having to decipher a dump or 
trying to print the contents of specific variables at what you guess is the critical point. 

If ^'ou wish to look onh' at ■•^articular '•^oints in the ■urogram or at particular variables there is 
also the ability to establish "break points" for these items, so that your debugging routines can 
be invoked only when certain conditions arise. You can also establish different routines for 
different break points, adding to the flexibility. 

Individual Instruction Execution 

Normally, all BASIC lines, including the ICALL statement, act as a unit. That is to say, 
whenever you press the y ) key, the line which is currently executing is allowed to finish 



before the program is actually interrupted. Thus, if you press ( i | during execution of the 
line — 

108 LET fl=i+l 

the line finishes and the variable A contains the value 2. Then the ( i | takes effect. The same is 
true of a line containing an ICALL statement. 



For example, if you press y during the execution of — 






then the assembly routine completes before the I H is honored. This is not always desirable, 
especially during debugging of the assembly routine. This technique does not allow you to look 
at the execution of the routine to help you determine what may be going wrong. 

The same problem occurs with the ^^^ilD key. Pressing Lsi^ causes an entire BASIC line to be 
executed. Thus, if you stepped through line 120 as above, the entire routine Sort would be 
executed, and you would not be able to observe its execution on an instruction-by-instruction 
basis. 



8-4 Debugging 



To permit you to analyze the execution of assembly language routines, an executable BASIC 
statement has been provided — 

I PAUSE ON 

Now, should you have the sequence in your program — 

lie IPHUSE OH 

120 ICflLL Sort<H<*>::' 



then pressing ( y J during the execution of line 120 would cause program execution to be 
interrupted after completion of whatever machine instruction is being executed at the time. 
Further, the assembly language source line associated with the following instruction is dis- 
played according to certain rules. 

If the source lines are still in memory when you press ( J (e.g., you just assembled the object 
code which you are running), then the source line is displayed. If the source is no longer in 
memory (e.g., the object code was obtained through an ILOAD), then the instruction displayed 
is the result of a "reverse assembly". If there is an operand with an instruction which is reverse 
assembled, then the octal value of that operand is displayed (this is because the reverse 
assembly process has no way of knowing what symbols you might have used to assemble the 
instruction originally). 



After pressing I y J, all you have to do to resume normal execution is press 

After pressing ( y J, you may want to observe the flow of execution of your assembly routine. 
This can be done by successively pressing the CEID key. Each time the key is pressed, another 
machine instruction is executed and the assembly source line associated with the next machine 
instruction is displayed. You may continue this way for as long as you like — until you press 
to allow processing to proceed uninterrupted until the end of the routine. 



Of course, the CHQ key can be used to step through the BASIC program as you are used to 
doing. That feature is unchanged. It is possible, therefore, to "step into" the assembly lan- 
guage routine from the BASIC (i.e., you need only CHID into line 120 above) and not have to 
use the § key at all. 



In summary, IPAUSE ON allows two unique features — 

• The ( p J key can be used to halt execution within an assembled routine. 

• The CUlL) key can be used to execute individual assembly language instructions. 
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TT\ATTr^r^ rf-^l 



oome Key inmgs to rememoer in using ine if Mu;3n uin laciiity 



• This is an execution-time debugging tool. You must be executing your previously- 
assembled object code with an ICALL statement. 

• If the source code is available for display, it will be displayed, otherwise the line is 
"reverse assembled". 

• Utilities are not stepped instruction-by-instruction, but rather as a unit. 

• The L^iiLJ key performs in BASIC just as before. 

• Keeping the CHQ key and the \^^ key depressed causes repeated execution of the step- 
ping function, the same as in BASIC. 

By way of example, suppose you had the following source code — 






yflL 1 
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Then the following would be the display lines you would see as you executed this program 
using the i^^ key — 









>tji4 yyUs'^l V-'t.'777'^ 









?gy uy065 Ui'47iSo LoopU'JEC R 



•=i =_U!in=i':t 



>0 yijy 

'fi CiPifi 



: Nt; 






3 yk^ciuU'^ 



-rcxf-rtiMt 

-'ut Ma. 



Note that the address of the instruction, as well as the octal value of the instruction, is displayed 
along with the source line. 



This stepping facility can also be used, quite effectively, with the IBREAK statement (discussed 
below). 
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btiould the IPAuSE ON facility be no longer desired, it can be turned off with — 



The two statements can appear repeatedly in a program, allowing the stepping facility to be 
used in testing some programs but skipping over already proven programs. For example, 
suppose you had two programs — Sorta and Sortn — but the first was already tested and the 
second was not. Then this sequence might appear in your program — 



1 4h TThLL 



Stepping through this sequence results in lines 110, 120, and 130 executing without interrup- 
tion, but line 140's call to Sortn would be executed instruction-by-instruction. 

Executing IPAUSE ON when the facility is already in effect causes no change. Similarly, execut- 
ing IPAUSE OFF when the facility is already off causes no change. 

Both IPAUSE ON and IPAUSE OFF can be executed from the keyboard. 

It is possible to define points in an assembly language routine where the execution should 
pause should it ever reach that point. These are called "break points". They can be used to 
pause execution — allowing you to utilize the stepping activity described above in IPAUSE ON 
or to investigate the contents of variables, etc. They can also be used to allow branching to 
some BASIC routine, giving you the power of BASIC in doing some of your debugging. 

Simple Pausing 

To simply pause at a break point, you need to execute the following statement in advance of 
reaching that point (either in the program or from the keyboard) — 

I BREAK {address} 

where {address} is the assembled location^ for the break point desired.^ Following execution of 
this statement, anytime the program execution reaches this address, it pauses. You may do any 
keyboard operations necessary at this point, or you may start stepping the program, (if 
IPAUSE ON has been executed), or you may resume execution using the ( S j key. The 
address must have been assembled before the IBREAK is executed. 

1 See "Symbolic Debugging" in this chapter for the definition of "assembled location" . 

2 The use of IBREAK significantly slows execution of assembly programs. 
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If you were to execute — 

lERERK Hook, 4 

then every time the fourth word past assembly label "Hook" is reached during execution, the 
program execution pauses. If you were to execute — 

I BREAK Hook +4 

then Hook is assumed to be a BASIC variable, and the result of the expression is assumed to be 
an absolute address using whatever the value of Hook is when the statement is executed. 

You can also specify the number of occurrences of reaching a break point before pausing 
should come into effect. This is done by executing — 

I BREAK {address} ; {counter} 

where {counter} is a numeric expression; any variables within {counter} are BASIC variables. A 
pause occurs when {address} has been reached {counter} number of times, {counter} is reset 
after each pause. 

When a break point is reached and a pause is to be taken, the pause takes place before 
execution of the contents of that address. 

After execution of the IBREAK statement, the contents of the assembled location for the break 
point are changed by the operating system; however, this does not affect the execution of the 
instruction contained therein. 

If an ICALL statement is executed from the keyboard and an IBREAK is active for a location 
within the ICALLed routine, program execution is returned to BASIC when the breakpoint is 
reached. Stepping of the assembly language routine is halted and the CRT is cleared. 

Transfers 

Instead of just pausing at a break point, it is possible to branch to a BASIC routine. The intent of 
this facility is to give you access to BASIC'S capabilities, particularly the printing and 
variable-testing facilities, during your debugging efforts. 
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The branch can be an^' of the three standard forms of BASIC branching — 

lERERK {address} [; {counter} ] CRLL {subprogram} 
IBRERK {address} [; {counter} ] GOSUE {line identifier} 
IBRERK {address} [; {counter} ] GOTO {line identifier} 

When either CALL or GOSUB has been designated, execution of the assembly language 
routine is suspended when {address} is reached. Then the designated subprogram or 
subroutine is executed. When that subprogram or subroutine is completed, then execution of 
the assembly language routine resumes with {address}. 

When GOTO is specified, an unconditional branch is taken when {address} is encountered and 
execution of the assembly language routine is terminated. 

{counter} performs the same as in the simple pausing form. 

In the GOSUB and GOTO forms, there is an "environmental" restriction. The {line identifier} 
must be in the same BASIC environment (i.e., main program or subprogram) as that in which 
the IBREAK statement is executed. More on this in "Environments" below. 

You should avoid recursive use of the ICALL statement when using the IBREAK statement to 
branch to a BASIC subroutine or subprogram. The problem arises when an ICALL statement in 
the BASIC debug subroutine or subprogram calls the broken assembly routine. The IBREAK 
transfer occurs at the same assembly routine address each time it is encountered. This process 
results in non-productive looping. 

Environments 

The GOSUB and GOTO types of break points are related to the BASIC "environment" (i.e., 
main program or subprogram) in which they are executed. Whenever an IBREAK statement of 
either type is encountered, the resulting break point is effective only for the environment in 
which the statement is located. The CALL version of break points is in effect in all 
environments. 

For example — 

209 SUE Test 

210 IBRERK Hook GOTO Check hook 



the break point established for "Hook" is good only in the subprogram "Test". Leaving 
"Test" causes the break point to be cleared. 
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Executing an IBREAK statement from the keyboard is effective only for the environment 
executing at the time the statement is made. For example, if the following program lines had 
been executed — 



200 SUE Test 
210 PHUSE 



and while the pause caused by line 210 is still in effect — 

J gj;.p|i||.::; Hook GOTCi Check hook 



is executed, then the break point established for "Hook" is good only in the subprogram 
"Test". As with the above, leaving Test causes the break point to be cleared. 

If no program is executing when an IBREAK is executed from the keyboard, then the main 
program is considered to be the environment for the break point. If the program is replaced, as 
with a GET or a LOAD, then the break point is cleared. 

If a LINK command is used to replace all or part of a program, existing break points are still 
active. If the LINK eliminated the line label or subprogram referenced in the IBREAK, then 
ERROR 186 results when the break point is reached. If a GET command is used to replace all or 
part of a program, all GOTO/GOSUB breaks are cleared. IBREAK CALLs are still active. 
Again, if the line label or subprogram referenced by the IBREAK is eliminated, then ERROR 
186 results. If the program is replaced with a LOAD, all break points are cleared. You must 
re-execute the IBREAK statements in the new program. Only ENT and SUB symbols are 
defined in this new program until an lASSEMBLE is executed. 

Care should be taken when calling BASIC subroutines or subprograms after an IBREAK has 
been set and before an ICALL has been executed. A CALL to a subprogram clears break points 
of the IBREAK... GOTO and IBREAK... GOSUB varieties; however, IBREAK... CALL is not 
cleared. This is because CALL executes an INORMAL which clears all break points except 
IBREAK... CALL. (An INOR^4AL is also executed when the Q key or Urr^Q keys are 
pressed). Here is an example of break points being cleared by a CALL — 

Clear ICOri ar-t-a. 

Set aside 100 loords, 

Hssernb 1 e all fnCidu 1 € s . 

Break at 1 ocat i on N i dd I e = 

CALL subprograiT! . 

Do assembly routine. 

80 Break found: PRINT '^Breakpoint found." ! Break subroutine. 
99 RETURN ! Subroutine end. 



10 


I DELETE ALL 




20 


ICijM 100 




30 


IHSSEMELE ALL 




40 


IBREAK Middle GOSUB Break foi 


r-id 


50 


CALL Cal lable 




60 


ICALL Entrypt 




70 


END 
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If y 

180 

280 
210 
220 
2:":fi 



^pt. 






OURi 

OURC 

Oi]R( 

OURi 

UURl 

UURi. 



IHT "Subproqr-; 
EEND 



I 






LDfl ^String] 

1 

I 
RET 1 



MudU 1 t rfimt 



! Rout i ne ent ry po i nt 



! Break 1 



! Return to ERSIC. 

! Module end. 

! CHLLed subprogram. 

! Subprogram end. 



The break point is cleared after execution of line 50. 

Keeping in mind that different BASIC environments exist for the main program, each 
subprogram and each multi-line function, IBREAK...GOTO and IBREAK...GOSUB remain in 
effect only within the BASIC environment in which they are declared. IBREAK...CALL remains 
in effect in all environments. A maximum of eight IBREAK...CALLs are allowed. 



Data Locations 

Break points can also be established for data locations. This is done with 



:HK Dfl i H {address} 



In this case, {address} is presumed to be a data location referenced by other instructions. 
Whenever it is referenced by execution of some instruction, the pause occurs. 

If you were to say — 



Z' Ci Cr Q L-"" T; CJ : Q ■_' .— :. 



then whenever "Renras" is referenced, such as in — 



lifi 



a pause would occur for that instruction. 
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A counter can also be specified with this form of break point — 

I BREAK DhTH {address} ; {counter} 

{counter} is of the same form, and operates in an identical fashion, to the counter of the 
non-DATA form of break point. 

Because the XFR machine instruction may access a particular location twice when it is 
executed, the break point on a data location may not operate correctly if the instruction 
referencing it is an XFR. The way to avoid this incorrect operation of the break point is to set 
{counter} to 2. (The only time this problem occurs is when the destination area for the XFR 
overlaps the origination area.) 

Symmetry suggests that you should also be able to branch to BASIC routines with the DATA 
form of break point just as you can with the non-DATA form. And so you can — 

I BREAK DATA {address} [ ; {counter} ] CALL {subprogram} 
I BREAK DATA {address} [ ; {counter} ] GOSUE {line identifier} 
I BREAK DATA {address} [ ; {counter} ] GOTO {line identifier} 

They operate in an identical fashion to transfers of the non-DATA type and are under the same 
"environmental" restrictions. 

In order to determine whether an address is being referenced, each instruction is "interpreted" 
(that is, analyzed for its components). Resultantly, a program runs much slower while an 
IBREAK DATA statement is in effect. 

In addition to the pausing capability, using IBREAK DATA also allows trapping on "protected 
memory" violations (see "Stepping vs. Running" section of this chapter). 

IBREAK Everywhere 

You may have a total of eight (8) break points (regardless of type) in effect at a given time, 
except for one extreme case. It may be desirable to establish a break point at every location in 
the ICOM region. This can be accomplished with — 



IBREAK H 



This statement overrides all other IBREAK statements and causes a pause before execution of 
every instruction in the ICOM region. There are also branching forms — 
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IEREHK all call {subprogram} 
IEREHK all go sue {line identifier} 
I BREAK ALL GOTO {line identifier} 

Note, however, that there is no {counter} in any of these forms. 

Number of Break Points 

As was mentioned above, there can be no more than eight (8) IBREAK statements in effect at 
one time, that is to say within the same environment. And only one IBREAK ALL can be in 
effect at a given time. 

In addition, there can only be one IBREAK or IBREAK DATA each in effect for a given 
{address}. Executing an IBREAK or IBREAK DATA with the same {address} as specified in an 
already effective IBREAK or IBREAK DATA statement causes the newly-executed statement to 
override the previous one. While there may be an IBREAK and IBREAK DATA both for the 
same {address}, the capability is not a useful one. 

Clearing Break Points 

There are a number of ways that break points can be cleared. One way as has already been 
mentioned, is leaving the BASIC environment, which clears any GOSUB or GOTO type of 
break points. Another way is to reassemble the module containing the break points. A third way 
is to execute an IN0R^4AL statement. This statement has the form — 

I NORMAL {address} 

After execution of the statement, whatever form of break point is established for the address 
(except IBREAK ALL) is cleared. 

If {address} is omitted in this statement — 

then all break points are cleared. This is the only way to clear an IBREAK ALL which may be in 
effect. 
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Interrogating Processor Bits 

During execution of a break point, the values of three processor flags are stored in specified 
registers so that you can interrogate them. They are — 

Decimal Carry stored as least significant bit in location 36B 
Extend stored as most significant bit in location 37B 

Overflow stored as least significant bit in location 37B 



Dumps 



A common tool of debugging is the memory "dump". This is a print-out (or display) of the 
contents of selected locations in the memory. A typical use is to dump areas of the ICOM 
containing data so that the actual contents at some point during execution can be compared 
with the expected contents. All of this is in the hope that the comparison yields differences 
which give a clue as to the source of the difficulties being encountered. 

This tool is provided through the IDUMP statement which has the form — 

I LUMP {location} [ ; {location} [ ; ...] ] 

This statement can be placed in a program to be executed (perhaps as the result of a branching 
IBREAK statement) or it can be executed from the keyboard (perhaps during a pause caused by 
stepping or IBREAK). 

Any number of {location}s can be specified. They can take a number of forms. The simplest 
is — 

{address} 

Thus, IDUMP {address} prints the contents of {address} to the current system printer. The 
contents are printed in their octal representation. For an explanation of {address}, see the 
"Symbolic Debugging" section of this chapter. 

{location} can specify a whole range of addresses by using the form — 

{address} TO {address} 
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With this form, the IDUMP statement prints the contents of all addresses starting with the first 
and ending the last specified {address}. If the second address is numerically smaller than the 
first, then a "wrap-around" through the end of memory into the top of memory is taken. For 
example, if you execute — 



then the contents of four addresses would be printed — those for 177776, 177777, 0, and 1, in 
that order. Again, the contents are printed in their octal (base-8) representation. 

Addresses are always specified in their octal representation, or symbolically (such as "Hook" 
or "Loop"). This is the same as for an assembled location, which is what {address} happens to 
be. 

Care must be used with symbolic addressing. In the statement — 



the first "Hook" is interpreted as an assembled location. Since the second "Hook" appears in 
an expression, it is interpreted as a BASIC variable. If it is undefined, this expression is 
evaluated as 4. To dump the fourth word past the assembled location "Hook", use the state- 
ment — 

TTliiMP |-J=-::-:L.- 



The output of the IDUMP statement is always printed to the current system printer. It is in octal 
form, unless otherwise specified. This specification is accomplished by preceding {address} 
with {mode selection}, which is one of the following — 



!-i=-; 



for ASCII character representation 
for binary representation (base-2) 
for decimal representation (base-10) 
D< for hexadecimal representation (base-16) 
IT for octal representation (base-8) 



Thus, the general form of {location} is — 

[ {mode selection} ] {address} [TO {address} ] 



8-16 Debugging 



As an example of all this, take the example program at the beginning of the chapter. If a couple 
of statements are added so that the main BASIC program reads — 



10 DIM H$[10] 

20 ICOM 100 

30 I ASSEMBLE Extract 

40 lEREHK Loop GOSUB Dump 

50 IDUMP 41 TO 104 ! Dump of ICOM region 

60 PRINT 

70 Loop: L INPUT hi 

30 IChLL Extract <H$) 

90 PRINT ■'<'' ;HS; ■■ >■■ 



100 


bU i Loop 


liu 




120 


! Dump H,E rt-qisters in octal form. 


130 


i string length in dec i rival form, and 


140 


! and the string m c^-aracter form 


150 




160 


Dump: IDUMP fl TO E;DEC Strinq;HSC S' 


170 


PRINT 


180 


RETURN 



String,! 



then running it results in the following print-out — 

000041: 0£10005 030462 031464 032454 033067 034071 022265 100003 022607 000012 

000053: 021335 000001 100207 000000 000205 002025 006025 142025 007756 002021 

000065: 170600 023753 022021 030016 070530 141714 012016 066004 054001 067774 

000077: 1702£il 026012 037740 002003 006003 166G'07 

000000 : 000 115 0000 1 2 

00 00 4 1 : +000 1 

000042: 12345, 6739$5'-; 

000000: 000071 000011 

000041: +£10010 

000042: 12345, 6739$5'-; 

000000: 000070 000010 

000041: +00010 

000042: 12345, 67Sy$5"; 

000000: 000067 000007 

000041: +00010 

000042: 12345, 67S9$5-v 



ayyoyy: uyyybb O000O6 
000 04 1 : +000 1 

000042: 12345, 67S9$5'; 



1 2o4r 
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Value Checking 



Value checking is a method of tracing the value of variables in your assembly language program 
using the interactive capabilities of the 9845. You already have been introduced to break 
points and dumps in earlier sections. The capability of value checking serves as a useful adjunct 
to these procedures. 

The value checking of assembly "variables" is similar to the monitoring of variables in BASIC 
during a debugging phase. Just as you would use a live-keyboard operation or judiciously 
placed PRINT statements to trace the execution of a program or the change in value of a 
variable in a BASIC program., so too can you use the monitoring tools for assembly programs. 

Functions 

Four additional functions are provided as extensions to BASIC which can be useful in the 
monitoring of values in an assembly language program. The four are — 



IHDR 



They can be used as other than monitoring tools, but their descriptions here are primarily in 
that context. As functions, these items can be easily adapted for use in the special function 
keys. 

DECIMAL 

This function has the form — 



'. {octal value} > 

The function converts an octal integer value between —177 777 and +177 777, inclusive, into 
its decimal representation. If the argument given is not octal, then an error (number 184) 
results. 

This can be used as a quick, simple way of converting octal numbers into the more familiar 
decimal value. Being a function, it can be used anywhere any other BASIC numeric function 
can be used. Often you will find it useful in PRINT statements which are a part of subroutines 
called by break points. 
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OCTAL 



NOTE 

The values resulting from the OCTAL function must be 
treated with care. Though the result of the function is an 
octal representation, the value is still base-10. This differ- 
ence is unimportant unless you are going to do arithmetic 
with the value resulting from the function. 



This function is the converse of the DECIMAL function. Its role is to convert decimal values 
between -65 535 and +65 535, inclusive, into their octal (base-8) representation. The func- 
tion has the form — 



ML < {decimal value} 



This can be used as a quick, convenient method of converting decimal numbers into their 
frequently used octal representations (a form which is useful because of its ready conversion 
into binary representation, and vice-versa). 

As an example of this, suppose the decimal value 15 is to be converted into octal. The method 
is — 



and the resultant value is 17, the octal representation of 15. Now, if the result has 1 added to it, 
as with the expression — 



ML. ••. 



the ultimate result is 18. This can be a surprise since the usual octal arithmetic suggests that the 
result of 17B -I- 1 be 20B. To get the proper octal result, the procedure is — 

The correct result can also be obtained with — 






or 



IMfli 



'.' 4- T\ F I 



iM: i ! .! 
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The preceding are examples of octal addition. Suppose you wanted the result of 17B + 14B. 
The expression used to obtain the correct result in octal representation is — 



The correct result is 33B. 



lADR 



This function yields the numeric value in octal representation of the address of an assembled 
location. The form is — 

I HDR< {assembled location} --^ 



As an example, take the case of the example program at the beginning of this chapter. The 
result of — 



is 76. 

This function can be viewed as a convenient method of determining the address of a symbol, or 
of an offset from a symbol. 

IMEM 

This function is a quick, convenient way to look at the contents of a specific location in 
memory. The result is a numeric value, in octal representation, for the contents of a specified 
address. The form is — 

■'. {assembled locaCon} )^ 



1 For an explanation of {assembled location}, see the "Symbolic Debugging" section of this chapter. 
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The function is similar in many respects to the IDUMP statement. It is easiest, perhaps, to list 
the differences — 

• IMEM is a function, where IDUMP is a statement. 

• IMEM deals only with a single address, where IDUMP can deal with many. 

• IMEM represents the value only in octal, where IDUMP can use many different representa- 
tions. 

• IMEM can be displayed and stored, where IDUMP can only be printed. 

An obvious use for this function is in a routine called by an IBREAK statement. By using the 
function in such a manner, perhaps in a PRINT statement, you can ease the burden of checking 
variables from the keyboard. You can even use the value returned as a comparison against 
some set of limits so that you print only when the value exceeds those limits. There are many 
other possibilities for its use. 



Interrogating Registers and Flags 

Interrogating the processor register A, B, P, R, Pa, Cb, Db, Dmapa, Dmama, Dmac, C, D, Ar2, 
Se, and Arl yields meaningful results only when execution of an assembly language subpro- 
gram has been suspended due to detection of a break point, or due to the use of the i^HD or 
keys (see Stepping Through Programs). 



Further, the values of cetain processor flags are stored in specific memory locations when a 
subprogram is suspended as described above. The flags are then available for interrogation as 
follows: 

Decimal Carry least significant bit of location SOB 
Overflow least significant bit of location 3 IB 

Extend most significant bit of location 3 IB 

It is important to note that interrogating an I/O register (R4, R5, R6, or R7) causes an input 
I/O bus cycle, using the current Pa register contents as the interface address. See Chapter 7 for 
details on the effects of such an action. 
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Patching is the practice of changing the contents of memory locations without re-assembling. 

Patching as a standard procedure does not come highly recommended in the programming 
world. Nonetheless, there are circumstances which arise that occasionally suggest patching as 
the most profitable course of action. 

To change a particular location in memory in the 9845 is not difficult. The statement to use is — 

ICHflNGE {assembled location} TO {octal expression} 

After execution of the statement, the specified {assembled location} contains the specified octal 
value. 

Changing the contents of a register is a common use of this facility. However, it should be 
remembered that attempting to change the contents of the I/O registers (R4, R5, R6, or R7) 
causes an output I/O bus cycle to occur, using the Pa register for the interface address. See 
Chapter 7 for details on the effects of such an action. 

Some precautions should be taken in attempting to change the DMA registers. The contents of 
Dmapa are set by the Isr_access utility and should not be changed while stepping. The contents 
of Cb and Db (contained in register 13 along with Dmapa) can be changed at any time. The 
contents of Dmac and Dmama can be changed but be sure that your DMA routine has DMA 
access at the time of the change. Changing the contents of these registers at a time when 
another routine has DMA access can have disastrous results. 
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Stepping vs. Running 



You should be made aware at this point of some conditions that exist during stepping that do 
not exist during a free run of a program. During stepping with the STEP key or when an 
IBREAK DATA statement is in effect, an assembly language program is not allowed to access 
(jump to or write into) certain portions of memory. These portions of memory are known as 
"protected memory" and error 187 results if an attempt is made to access them. 

All memory is protected except — 

• The ICOM region. 

• BASIC'S "value" area (the region where BASIC variables are stored). 

• BASIC'S common area (the region where BASIC common variables are stored). 

• The processor registers. 

• The temporary values stored in the base page (pre-defined symbol "Base_page"). 

• The utilities. 



Protected memory exists only when you are stepping a program, when an IBREAK DATA 
statement is in effect, or when you are using the ICHANGE statement. This feature reduces the 
danger of inadvertent destruction of data or nonsensical execution of data by the processor. 
Keep in mind that this feature does not exist when the program is free running. 

Since the contents of the processor registers are stored in read /write memory, a full 16 bits is 
used to represent the contents of each register, regardless of whether the register is a four-bit 
register (Pa,Dmapa,Se) or not. Only the least significant four bits are of interest when an 
IDUMP statement is used to interrogate the four-bit registers. 

The second major difference between stepping and free running is that the processor registers 
displayed by an IDUMP statement are, in actuality, read/ write memory locations. These mem- 
ory locations are updated only when the program is stopped. Therefore, running a program 
that changes the contents of the processor registers does not appear to have changed them 
when the IDUMP statement is used. 

In addition, a breakpoint cannot be set for a location within an interrupt service routine. An 
interrupt service routine cannot be stepped. Attempts to perform either function will lock up the 
computer. 
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Chapter j^ 

Errors and 
Error Processing 



Summary: This chapter contains a discussion of Assembly Language ROM and other 
related errors, and what causes them. Included are methods for trapping errors and 
possible methods for correcting them. 

Whether you are writing or accessing an assembly language routine, it is possible to encounter 
an error resulting from your actions. The intent of this chapter is to give some guidance as to 
how certain errors can be handled. It is not intended as a definitive checklist of what can go 
wrong, nor is it an exhaustive treatment of the means to correct the difficulties which are listed. 
Rather, it is meant as a reference for some of the things which can go wrong, what might cause 
them, and how to deal with them. Each programmer has a unique method of approaching the 
problem of error processing and there is no way to anticipate all of them. Even so, the following 
should offer some assistance in identifying the source of an error. 

Not every machine error is covered here — only those directly related to writing or accessing 
assembly language routines. A complete listing of error messages (though not in the same detail 
as in this chapter) can be found in Appendix J. 

Error numbers 900 through 999 are reserved for your own use (with the Error exit utility). 



Types of Errors 



There are three types of errors associated with assembly language routines: those which 
occur during the writing (or entering) of the source code (called "syntax-time" errors); those 
which occur while assembling the source code (called "assembly-time" errors); and those 
which occur during the execution of an assembly language routine (called "run-time" errors). 
Some of these errors can be anticipated and trapped, others cannot. 
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Syntax-Time and Assembly-Time Errors 

Syntax errors are caught when entering source code, usually with the message — 

IMPROPER I source: STRTEMENT 

The error can then be immediately corrected and the statement reentered. A side-effect of this 
entry-time check of the syntax is that the time required for assembly is greatly shortened over 
what it would be if syntax-checking were deferred until assembly. 

Errors encountered during the assembly process are indicated by the assembler in three ways: 

• The message — 

ERROR 192 IN LINE nn 

is displayed, nn is the line number of the lASSEMBLE statement. This is a fatal BASIC 
error, unless otherwise trapped. 

• Each line in the source code containing an assembly error is printed on the current system 
printer. Included is the message — 

Hi Hi C p !~" r":p J|l Hi 

followed by the error type. 

• The message — 



H HoSEMBLY 



follows the listing of the individual errors. The total number of errors is also printed. 
An explanation of the individual assembly-time errors can be found at the end of this chapter. 

Run-Time Errors 

Run-time errors can sometimes be anticipated. They come at two distinct times, and your error 
processing is different depending upon which of those times are of concern. The times are 
"program development" and "production run". 

During program development, errors normally are handled using the debugging techniques 
detailed in Chapter 8. Care should be taken in recognizing errors during development. Not all 
of them are obvious or indicated by an error message — many simply lock up the machine. 
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Durino the runnina of Droduction fdebuQoed) routines, errors can be caused bv th( 
routines. For instance, the user may inadvertently assign an argument a value of zero when that 
argument is to be used as a divisor within the assembly language routine. You should try to 
anticipate these usage errors and program procedures to trap them. 

There are many alternatives for actions to take when your routine encounters and traps a usage 
error. For example, you may wish to assign a value to a particular return variable, or you may 
want to print a warning message, or, perhaps, to correct the value and proceed with the 
routine. Another method is to notify the user by issuing a BASIC error message. Such messages 
can be issued through the Error_exit utility discussed below. 

Of course, you need to tell the users (in the documentation of the routine) what kind of errors 
can occur, when they can occur, and what to do about them. 

UTILITY: Errorcxit 

The Error_exit utility provides you with the capability of aborting an assembly language 
routine by "creating" a BASIC error. Two types of BASIC errors can be created — 
"recoverable", which can be trapped by a BASIC ON ERROR statement; and "non- 
recoverable" (or "fatal"), which cannot be trapped. 

General Procedure: The utility is given the number of the error to be created. Then the utility 
is called with the JSM instruction, but no return is made to the original assembly language 
routine from the utility. Instead, the utility uses the information placed on the return stack to 
help create the error. The return stack is appropriately "cleaned up" and control is returned 
either to the BASIC driver (if the error is non-fatal) or to the operating system (if the error is 
fatal). 

Special Requirements: Error numbers are passed to the utility in the A register. The value of 
the error number is placed in bits 0-14. Bit 15 is set if the error is to be non-recoverable. If bit 
15 is not set, the error will be recoverable. Error numbers 32 762 through 32 767, with bit 15 
set, are reserved by the operating system and should not be used. 

If you are setting bit 15 to specify a non-recoverable error, the use of negative numbers should 
be avoided. For example, loading the A register with -8 does not result in non-recoverable 
error 8. This is because the error number in bits 0-14 is not 8. A suggested method of setting bit 
15 is — 
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In addition, it is suggested that you limit your error numbers to three digits. The block of error 
numbers 900 to 999 are reserved for your use in assembly language routines and will not be 
used in future Hewlett-Packard products. 

Calling Procedure: 

1. Load the error number into the A register. 

2. Call the utility using the JSM instruction. 

Exit Conditions: The utility returns control to the BASIC driver which called the routine, 
appropriately setting conditions so that ERRL, ERRM$, and ERRN work as expected. Also 
triggers ON ERROR, if applicable. 

The utility can be used anywhere in your assembly language, wherever you would like to abort 
the execution of the current assembly language routine and where you would like to indicate to 
BASIC what reason (error) caused the abortion. 

For example, suppose somewhere in one of your assembly routines you wanted to abort the 
routine if a certain variable (Flag) is non-zero at a certain point. Suppose also that the variable, 
when non-zero, contained the error number, then your program could look like — 

I SOURCE LDR Flag 

I SOURCE 3ZR *+2 

I S OU R C E J S \'i E !■"■ r o r- t x i t 

Similarly, there are some utilities which, when an error is encountered, return an error number 
in register A. In these cases, a quick two-instruction sequence can give you an error-related 
abort. For example, the Rel math utility is such a utility — 



SuURlJL 


jsn 


Re 


SOURCE 


SZR 


*+ 


SOURCE 


jsn 


hr 



As an example of a fatal error, suppose the error desired is 8. The error sequence could be — 
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Run-Time Messages 



The following is a list of the system error messages you, or the users of your routines, may 
receive should something go wrong retrieving, using, or storing assembly language routines. A 
possible corrective action, or actions, is included in the discussion of the error. 






ROM missing, or configuration error. To operate the 9845, all system ROMs 
must be in place. In addition, to write assembly programs, the Assembly 
Execution and the Development ROM must also be installed. Perform the 
system test if the problem persists. 

Memory overflow. You may have specified an ICOM which is too large for 
your current available space. Some things to try: select a smaller ICOM size; 
execute SCRATCH C (if no important data remain in common), delete mod- 
ules and reduce the ICOM size; segment your BASIC programs; segment your 
assembly programs. The error may also be caused by trying to load modules 
which are too large for the current ICOM region (either collectively or indi- 
vidually) or by placing a COM statement before an ICOM statement. 

The number of arguments passed by an ICALL statement exceeds the number 
of parameter declarations in the subroutine entry section. This error is not 
given if the number of arguments is equal to or fewer than the parameter 
declarations. The actual number passed is stored in the word reserved by the 
SUB pseudo-instruction. 

Improper argument in DECIMAL or OCTAL function. The OCTAL function 
has a range from — 65535 to + 65535. The DECIMAL function has a range 
for its arguments of — 177777B to + 177777B. Reference made to an abso- 
lute address greater than 177777B or 65 535io. 

Break Table overflow. A maximum of eight breaks can be established with the 
IBREAK statements and be in effect at one time. If eight breaks are in effect, 
then to allow other breaks to be established it is necessary to clear previous 
breaks using the INORMAL statement. 

Undefined BASIC label or subprogram name used in IBREAK statement. 
When the IBREAK statement is executed, an undefined label or name is al- 
lowed, but when the break actually occurs, the label or name must exist. 
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Attempt to write into protected memory; or, an attempt to execute an instruc- 
tion not in the ICOM region. This is the result of an attempt to branch outside 
of permissible areas or to change the contents of memory outside of the per- 
missible areas. There is probably a difficulty in the logic of the program which 
needs to be corrected. This error occurs when the tlilD key is being used, an 
IBREAK DATA statement is in effect, when using the ICHANGE function or 
when the IBREAK statement is used to break at a location in a non-existent 
module or at a location beyond the current ICOM region. 

Label used in an assembled location not found. Symbolic addressing requires 
that all assembly symbols be resolved by execution time. This error probably 
results from a misspelling of a label or forgetting to assemble the module 
containing the label. 

Doubly-defined entry point or routine. A module being assembled (with an 
lASSEMBLE statement) or loaded from mass storage (with an ILOAD state- 
ment) contains a SUB or ENT entry point with the same label as a SUB or ENT 
entry point within a module already resident within the ICOM region. Check 
the other routines for the duplicate occurrences. 

Missing ICOM statement. You must include an ICOM statement to create your 
ICOM region before assembling or loading modules. Program an ICOM state- 
ment of adequate size and re-run the program 

Module not found. The module indicated in an ISTORE or lASSEMBLE 
statement is not currently resident in the ICOM region. Check the module 
names used in your ISTORE statement to find the one which is missing from 
memory. 

Errors in assembly. At least one error was encountered while assembling one 
of the modules in your lASSEMBLE statement. 

Attempt to move or delete module containing an active interrupt service 
routine. This is the result of trying to reduce the size of the ICOM region (or to 
eliminate it), or trying to delete a module, when one of the affected modules 
contains an active interrupt service routine (ISR). The only ways to allow the 
action to take place are to SCRATCH A (which affects a number of other 
things) or to inactivate the ISR. To inactivate the ISR, consult the routine's 
documentation, or press Reset (^oNTRaj^sropj) 

IDUMP specification too large. The resulting dump would be more than 
32 768 elements. 
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Routine specified in ICALL not found. You are specifying the wrong routine 
name or you are failing to load the correct module. Double check the 
documentation indicating the location and name of the routine. 

Unsatisfied externals. Symbolic addressing requires that all references to sym- 
bols outside the current module be resolved at the time any routine within the 
current module is executed. This may possibly be a missing ENT instruction 
within another module. 

Missing COM statement. The routine you are calling is expecting to find or 
place some of its data in common, but you are not providing the COM state- 
ment required. Add the appropriate COM statement in the BASIC program 
and re-run it. 

BASIC'S common area does not correspond to assembly module require- 
ments. The routine you have called is expecting to find or place some of its 
data in common, but your COM statement does not match up with the assem- 
bly COM declarations in either type or size. Check both the COM statement in 
the BASIC program and the COM declarations in the assembly routine. 

Insufficient number of BASIC COM items. The routine you are calling is ex- 
pecting to find or place some of its data in common, but your BASIC COM 
statement does not provide enough variables to satisfy the routine's needs. 
Check both the COM statement in the BASIC program and the COM declara- 
tions in the assembly routine. 
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Assembly-Time Messages 

The following is a list of the assembler error messages you may receive while assembling a 
module. All of these errors cause a "fatal" error, which means that the assembly produced no 
object code. After the error has been corrected, it is necessary to re-assemble the module 
containing the error. A possible corrective action, or actions, is included in the discussion of the 
error. 

DD Doubly-defined label. A label can only be defined once in a module. In addi- 

tion, any label used in an EXT instruction is restricted from being used again as 
a label in the module. Check all spellings; change a label name to something 
else, if necessary. Mixing SET and EQU on the same variable may also cause 
this error to occur. 

EN END statement missing; or module name does not match. The END statement 

(in an ISOURCE statement) must be included to signify the end of a module. 
The name in the END statement must match the name used in the immediately 
preceding NAM statement. Particular ones to look out for: assembling more 
than one module at a time, but leaving out the END instruction between 
modules; or, the END statement is not in the same BASIC environment as the 
NAM statement. 

Ei -i Expression evaluation error. This is a result of a mismatch of element types in 

the operand of an instruction. The particular prohibited forms are: relocat- 
able + relocatable; external ± external; using the relocatable or external 
forms with the * or / operators. Check the spelling and type of your symbols in 
the expression. 

LT Literal pools full or out of range. You may have exhausted the storage given in 

your literal pool (LIT) declarations. In this case you should add more LIT 
declarations or increase the size of the ones you have. Another cause of the 
error can be using a literal in an instruction and there is no literal pool within 
512 words of the instruction. Additionally, for some instructions, the assem- 
bler attempts to create an indirect reference automatically and requires a lit- 
eral pool within 512 words of the instruction. In either case, add another literal 
pool (using a LIT instruction) within range. 
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ICOM region memory overflow. The current module being assembled has 
caused object code generation which exceeds the current memory allowance 
for the ICOM region. Either you must re-run the current main BASIC pro- 
gram with a new ICOM statement increasing the ICOM size, or you must 
rearrange your assembly so that the module fits. This latter course can include 
deleting other modules or rewriting the abortive module so that it requires less 
memory. 

Operand out of range. Some instructions using indirection require a relocat- 
able expression to evaluate to an address within 512 words of the current 
address. Skips must be no more than 32 words in either direction. The EXE 
instruction requires a register (0 to 31) and the instructions in the Stack Group 
require registers in the range of to 7. Check to see that the operand used is 
within the range appropriate for the instruction. Also, check the spelling on all 
symbols to see that the right symbol was used. 

Parameter declaration pseudo-instruction out of sequence. The ANY, FIL, 
INT, REL, SHO, and STR pseudo-instructions must follow a SUB or COM 
pseudo-instruction, or be a part of a group of such pseudo-instructions which 
follow a SUB or COM pseudo-instruction. Any other appearance of these can 
cause this error. It can also be caused if a SUB sequence does not terminate 
with a machine instruction with a label. Check to see that you have not inad- 
vertently omitted the SUB or COM, or have placed another instruction in 
between the pseudo-instruction and its SUB or COM. 

Incorrect type of operand used. Each instruction requires that its operand be 
of a certain type — relocatable or absolute. Check the type of all symbols used 
in the expression in the operand and see that they correspond to the type 
required by the instruction. If you are using a constant, check to see that a 
constant is allowed by the instruction. 

Undefined symbol. By the end of the assembly, all symbols must have been 
defined, either by use as a label on an instruction or as a symbol associated 
with a value through an EQU, EXT, or SET pseudo-instruction. A symbol not 
so defined (except those pre-defined by the assembler) and used in the as- 
sembly, causes this error. Check the spelling of all undefined symbols to make 
sure that you did not intend something else. The symbol otherwise has to be 
defined, either by label or EQU, EXT, or SET. 
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Chapter 10 

Graphics 



Summary 

The graphics topics described in this chapter include displaying the graphics 
raster by setting individual pixels, reading and writing full words, the cursor oper- 
ations, and line drawing. 



Introduction 

Computer graphics is the computer-aided creation and manipulation of images. These images 
typically appear on the screen of a CRT or are drawn by a plotter. This chapter explains the 
fundamental commands and techniques used to create images on the CRT of the System 45 
using assembly language. Of course, your System 45 must have the graphics option installed in 
order for graphics to be implemented. 

The advantage of using assembly language rather than BASIC to create and manipulate images 
on the CRT is one of speed. Graphical data can be manipulated, and input information can be 
plotted in real time using assembly language in many cases where BASIC could not be used. 

The CRT graphics is thought of as being a peripheral on select code 13. Displaying graphics 
images from assembly language is essentially an I/O operation to that select code. 
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The Graphics Raster 



The CRT of the System 45 computer is capable of displaying two independent rasters (display 
areas). These are the alphanumeric raster and the graphics raster (when the graphics hardware 
is installed). When the computer is turned on, the alphanumeric raster is displayed. This is the 
raster used to display alphanumeric characters when entering programs, displaying program 
results, etc. With a single command (GRAPHICS) from BASIC or a short sequence of instruc- 
tions from assembly, the graphics raster is displayed. Both rasters cannot be displayed simul- 
taneously. The alphanumeric and graphics rasters are illustrated below - 
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Displaying the Graphics Raster 

The graphics raster is displayed from your programs by one of two methods. The first involves 
executing the GRAPHICS command from BASIC. The graphics mode is exited and the al- 
phanumeric raster is displayed with the EXIT GRAPHICS command. 
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The second method involves executing a short sequence of assembly language instructions. 
The sequences used to enter and exit graphics from assembly are — 
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Note that clearing bit 15 of word 70000B causes the graphics raster to be displayed and setting 
this bit displays the alphanumeric raster. When the computer is turned on, bit 15 is automati- 
cally set. It is imperative that the instructions referencing register 35 appear in the raster control 
program segment. Failure to include these instructions will lock up the computer. 
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The graphics raster is subdivided into 254 800 individually addressable dots or pixels. The 
raster is 560 pixels wide and 455 pixels high. Pixels are specified by their X (horizontal, 0-559 
and Y (vertical, 0-454) coordinates. Each pixel can be turned on or off, producing the graphics 
image. This on/off information for each pixel is stored (one bit per pixel) in a separate memory 
known as the graphics memory. 



The graphics memory consists of 16 384 16-bit words of read/write memory. Each bit of the 
graphics memory determines the on /off status of an individual pixel. This memory contains 
information even when the graphics raster is not displayed. 
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The graphics memory is mapped to the graphics raster in the manner represented by the 
following illustration: 
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Graphics Memory Map 

Each pixel has a word address and a bit address associated with it for communication purposes. 
For example, word 0, bit holds the on /off information for the pixel in the upper left corner of 
the raster and word 16 378, bit 15, is mapped to the pixel in the lower right corner. As the 
illustration indicates, word addresses represented by 36Y + 35, and 16 379 through 16 383 
are not displayed. 

The X and Y coordinates of an individual pixel are translated into word and bit addresses with 
the following formulas: 

word address = (36*Y) + INT(X/16) 
bit address = X MOD 16 



The origin, point (0,0), can be moved to the lower left corner of the raster by simply subtracting 
the Y (vertical) coordinate from 454. This is done in some of the examples for consistency with 
BASIC commands involving X,Y coordinates. 
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Graphics Operations 

Checking for Graphics Hardware 

To test that the graphics hardware is present, execute the following statements 



i_J_': i 

STR Pa 
LDh R5 



■ZL 



The graphics hardware is not present if R5 = 0. 

Overview 

There are several different operations which the graphics hardware can perform. However, 
each operation is accomplished by issuing a command and then transferring data to or from 
select code 13. This section discusses the general procedures used to carry out these opera- 
tions. Details necessary for each operation (such as command and data encoding) are discuss- 
ed in later sections. 

The following graphics operations are available: 

• Writing individual pixels 

• Writing full words 

• Clearing full words 

• Reading full words 

• Cursor operations 

Each graphics operation has a unique control code associated with it that is stored in register 5 
with a STA R5 instruction. The control register is represented here — 



15 


14 


13 


12 II 


10 


9 


8 


7 


6 


5 


4 


3 


2 1 





unused 


INT 


DMA 


RST 


AH 




UpCOQc 



where: 

INT = interrupt enable bit 

DMA = DMA enable bit 

RST = reset bit (always sent with a new control code) 

AH = auto-handshake bit( for DMA operations) 
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Since each graphics operation can be carried out by handshake, interrupt or DMA, there are 
many combinations of control codes. 

The general algorithm for each operation includes the following steps — 

1. Verify that the graphics hardware is present and operational. 

2. If interrupts or DMA are to be used, call Isr_access to obtain the necessary access. 

3. Wait for the graphics hardware to become ready. 

4. Store the control code identifying the operation to be performed and any interrupt or 
DMA enable information into R5 of select code 13. 

5. The data necessary for the operation is sent to or received from select code 13. 

6. If another operation is to be performed, continue with Step 3. 

7. If interrupts or DMA are used, access must be released. 

In general, the data transfer (Step 5) can be made using programmed I/O or DMA methods. 
However, interrupt is not recommended where speed is a consideration, and for some opera- 
tions, only programmed I/O is recommended. When choosing between programmed I/O and 
DMA, keep the following in mind — 

• Programmed I/O is easier to implement but may or may not generate the faster 
throughput. 

• There is only one DMA channel. The rules of access to the DMA channel prevent attempts 
by two I/O tasks which need the DMA channel (your graphics task and a disc or I/O 
ROM operation, for example) from occurring simultaneously. In addition, DMA activity 
cannot occur at the same time as a synchronous I/O task (such as writing to or reading 
from a tape cartridge). 

• The maximum data transfer rate to or from the graphics hardware using DMA is twice that 
of programmed I/O. 

• When using DMA, the Isr_access utility must be called before using the DMA channel. In 
addition, all data to be transferred to the graphics memory must be in contiguous memory 
locations within the ICOM region (i.e. a buffer area). Thus the overhead encountered in 
starting a DMA transfer is higher than that involved in starting a programmed I/O trans- 
fer. 

• Several transfers may be initiated as a result of a single ICALL. In this case, the Isr_access 
utility would be called only once and the resulting overhead distributed over all the 
transfers. 
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Generally speaking, then, if ease of implementation is a major concern or if the data transfers 
are short and not numerous, then programmed I/O is the preferred technique. If there are 
m.any transfers or they are long, the additional overhead of using DMA v^ill be overcome by the 
faster transfer rate, resulting in higher throughput. 

Operation: Writing Individual Pixels 

Individual bits within the graphics memory can be set or cleared using the "write pixels" 
command. This capability might be used, for example, within a line drawing subroutine to turn 
on a sequence of pixels. 

General Procedure: 

• A "write pixels" command is stored in R5. 

• A data transfer is started to send word address, bit address, and new value for each bit to 
be changed. 



Special Considerations: 

• The control code for the "write pixel" command is as follows — 
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where: 

INT = interrupt enabled bit 

DMA = DMA enabled bit 

- = don't care 

• The data must be in a special format consisting of two words per bit to be changed. This is 
represented in the following illustration. 
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where: 
CWA 
BA 
D 



= complemented word address 
= bit address 

= data value {1=ON,0 = OFF) 
= don't care 
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Thus for each pixel to be set or cleared, two words must be transferred to select code 13. 
Either DMA or programmed I/O can be used. 



Writing Pixels Using Programmed I/O 
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Writing Individual Pixels Using DMA 
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SUE 








300 


ISOURCE 


Write pixe 


i dna 


LDA =13 




! Put se 1 ec t c ode i n Pa 


3 1 


ISOURCE 




STA 


Pa 






320 


ISOURCE 




LDA 


R5 




! Check for GRAPHICS hardi-iE 


330 


ISOURCE 




SZA 


No graphics 






340 


ISOURCE 


Try_aqa.iri: 


LDA 


= Isr 




! Get DMA Resource 


350 


ISOURCE 




LDE 


= ( 64*256 ) + <^; 


* 1 6 ' 


+ 13 


360 


ISOURCE 




jsn 


Isr access 






37ti 


ISOURCE 




jrip 


Tr;,.' again 






380 


ISOURCE 




LDA 


Count ' 




! Set Drr^ac to Count 


390 


ISOURCE 




STfl 


Dfftac 






400 


ISOURCE 




LDA 


=Euffer 




! Set D^f^a^i■^El to BUFFER addr^ 


410 


ISOURCE 




STA 


Dfrana 






420 


ISOURCE 




SDO 






1 Set DMA direction to OUT 


430 


ISOURCE 




DMA 






! Notify DMA hardware 


440 


ISOURCE 




LDA 


=51E+390B 




! Send DMA WRITE pixel Comr 


450 


ISOURCE 










1 NOTE: Bit 5 IS ONE 


460 


ISOURCE 




sPC 


* 




! Wait for fiag 


470 


ISOURCE 




STH 


R5 






480 


ISOURCE 




RET 


1 




I Return to BASIC 


490 


ISOURCE 




1 








509 


ISOURCE 


No graphic 


s : RET 


1 






510 


ISOURCE 




1 








•J 20 


ISOURCE 


I sr ; 


LDA 


-0 




! End o-f' transfer interrupt 


530 


ISOURCE 




STA 


R5 




! Clear control register 


549 
550 


ISOURCE 




JMP 
1 


End isr high 


,1 


' ^■^'^^^'^ ^^-fl access 


560 


ISOURCE 




END 


writ.e___p-ixel 


dna 


! Module end 
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Operation: Writing Full Words 

The "write words" command is recommended when all bits within a graphics memory word are 
to be changed, and especially when several contiguous words in the memory are to be 
changed. 

General Procedure: 

• A "write words" command is stored in R5. 

• A data transfer is started to send data to the graphics hardware. The first word sent 
indicates the starting address within the graphics memory and subsequent words are 
stored into the graphics memory at sequentially increasing addresses. 

Special Considerations: 

• The control code for the "write words" command is as follows — 



15 


14 


13 


12 


II 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 







INT 


DMA 


1 





1 














where: 

INT = interrupt enabled bit 
DMA = DMA enabled bit 
- = don't care 

The data sent to the graphics hardware must be in the format illustrated here 



CWA 



data 



data 



data 



where: 

CWA 

data 



= complemented word address 

= the data to be written into the graphics memory 
(Note that the most significant bit of each data word 
represents the leftmost bit (bit 0) within the graphics memory. 
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• Recall that while there are only 35 words of graphics memory data displayed in each row 
of the CRT raster, there are actually 36 words in the memory for each row. (One word is 
never displayed.) When using the "write words" command to write data into the last 
words of one row and the first words of the next row, you must remember to supply data 
for the "extra" word. 

• Either DMA or programmed I/O can be used. 
Writing Full Words Using Programmed I/O 



4fi 









ibui. 



ta2 t:ah 



1H1 



JSM \^etj-y3. 



UE =uat.al jcai- 



.Dh =: 
;TH p.; 



! Nodule ran-ie 

! ytoraQt' + or v 

! Storaqp for liRTR WORIi 



coord ii 



rst DHTH WUKjJ 



4-i-y 






LDH 
MPV 
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:omf:. 



H Pu 
iR Be 



DHiH ICiRE 






DhTH WC 



IH 



"R WORD 



iqer 
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Writing Full Words Using DMA 



^:.-j"\ ,=.-_-.■ 


■jy 




!..i..l 

Ill 

1 

l.i.l 


HLL 




bCLERR 






GRflPHICS 






SChLE 8, 


^i^i9, =. 


3, 4 


FRRME 






MOVE 100 


d.-:4. 


-10 


DRAW 458 


,454 


-45 


INTEGER 


■i , V , i 


JOu 


inSSEMEL 


E 14 r" 


te 






RLL W 



580 

520 

530 
540 



■^•riu 

470 
430 
490 

510 

5l i 

51 3 



iSU 


: i'^r'i 


ISC 


URC 


TCfj 


URC 


i-iL 


URC 


ISC 


URC 


I sc 


URC 


ISC 


URC 


ISC 


URC 


T y>r 


JRC 


ISC 


UKL 

URC 


I sc 


URC 


ISC 


URC 


TSC 


URC 


I sc 


URC 


ISC 


URC 


ISC 


URC 


T;I;f 


URC 


I SC 


URC 


I sc 


URC 


ISC 


URC 


ISO 


JRC 


ISC 


URC 


ISO 


JRC 


I sc 


_i 'r:\ i_ 


ISC 


JRC 


ISO 


JRC 


J'-,f 


JRC 


ISC 


URC 


7 Q:~ 


URC 


ISC 


URC 


ISC 


URC 


T SI" 


URC 


I sc 


URC 


TC;|- 


URC 


ISC 


1 ipr 


.1 bL 


URC 


I sc 


1 !p|~ 


ISU 


URC 


ISC 


JRC 


ISC 


JRC 



h 


tXT 


Get ■■..alue ! 


E 


EXT 


Isr .access 


E X coord: 


^"SS 


i ! 


E ^■s^coord: 


ESS 


1 1 


E Count : 


ESS 


1 i 


E Cua: 


pC;C; 


1 ^ 


E Eufft-r: 


Ess 


16334 ! 


E 


SUE 




E X_parrn: 


INT 




E '>■' ca-rTfi : 


INT 




E Cour!i;._parii 


: INT 




F Mr-it. c:- i.snr-r 


: LDR 


=X coord i 


E 


LDE 


=X pEirrn 


E 


JSM 


Getj...'=iiue 


E 


LDR 


=Y coord \ 


E 


LDB 


='r_pEirni 


E 


JSf1 


Get ^.-alue 



DecT 



KUh 






Liiij — Uount j:j3.rrn 

Jof'l bet -.^'3. 1 ue 

flliR =1 

.JMP R:^in 



Graphic: 



• ner-f . l. 


Jt- 


V 


LDR 


=:; 


ifo 


riPY 






LDB 


,':■:,' 


c 


SER 


4 




HDH 


■p; 





T. O- 


'iGt - I' 


■ Y 


to 


-age *":^ 


• NORD cour- 




y, c:-, .= -,7- 


■d bJuRIi RDI 


IJL 


-O'-'-EL ? 


Storaae t 






■40 GKHrHIi 
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Operation: Clearing Full Words 

Clearing words within the graphics memory can be accomplished using the "write pixels" or 
the "write words" commands discussed previously. However, if many sequential words are to 
be cleared, the most efficient way is to use the "clear words" command with DMA. This 
operation is identical to the "write words" command including the data transfer, except that 
the data is ignored by the graphics hardware and zeroes are written into the graphics memory. 
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General Procedure: 

• A "clear words" command is stored in R5. 

• A data transfer is started to send data to the graphics hardware. The first word sent 
indicates the starting address within the graphics memory. Each subsequent word trans- 
ferred causes one word of graphics memory to be cleared. 

Special Considerations: 

• The control code for the "clear words" command is as follows — 



15 


14 


13 


12 II 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 







INT DMA 


1 





1 





1 








INT 
DMA 

where: 



= interrupt enabled bit 
= DMA enabled bit 
= don't care 



• The data sent to the graphics hardware must be in the format illustrated here — 



CWA 



data 



data 



data 



where: 

CWA = complemented word address 

data = data is ignored 

Recall that while there are only 35 words of graphics memory data displayed in each row 
of the CRT raster, there are actually 36 words in the memory for each row. (One word is 
never displayed.) When using the "clear words" command to clear the last words of one 
row and the first words of the next row, you must remember to allow for the "extra" word. 
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LRHrHiCS, 

icon 20^ 






yCHLE 



H 



19y IHTEbhR '^, Y, Uount- 

120 ! "" 

130 Count =500 

140 FOR X=100 TO 400 



160 IChLL Cltvar_word<r^, TjJount 

170 NEXT X 

1S0 ! 

190 STOP 

200 ! 

210 I SOURCE 

220 I SOURCE 

230 I SOURCE 

240 I SOURCE H coor-d" 



NAM CI ear_i.jorid_drr!.3. ! Module nasne 

EXT Get_'-.-alue ! Declare ext erral s 



41 H 



4by 
490 



: ■. ■■-■ L- 






KL-in 


x__f;arr 


i^ 


KUb 


V parr 


; " 


RCE 


Count. 


P3. 



-DH 



MPV 
LliE X 

RDH =- 



JH =1: 

fH r:ni 



iax a i I oweo 
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"1 iirrkinv=i 



Hot i f;,-- DMA K3.rd0.ar 



1 qr 






ibO-- 



Operation: Reading Full Words 

The data in the graphics memory can be retrieved using the "read words" command. This is 
the only way data can be retrieved since there is no "read pixels" command. This capability 
might be used to store graphic images on mass memory or to update the graphic image using a 
read-modify-write algorithm. 

General Procedure : 

• A "read words" command is stored in R5. 

• A single word is sent to the graphics hardware to indicate the starting address within the 
graphics memory. 

• An input data transfer retrieves consecutive words from the graphics memory starting at 
the specified address. 



Special Considerations : 

• The control code for the "read words" command is as follows — 



15 


14 


13 


12 II 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 







INT 


DMA 


1 





1 


1 











where: 

INT 

DMA 



= interrupt enabled bit 
= DMA enabled bit 
= don't care 
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The data sent to the graphics hardware must be in the format illustrated here — 
15 14 13 12 II 10 9 8 7 6 5 4 3 2 I 



CWA 



where: 

CWA = complemented word address 

Recall that while there are only 35 words of graphics memory data displayed in each row 
of the CRT raster, there are actually 36 words in the memory for each row. (One word is 
never displayed.) When using the "read words" command to read data from the last 
words of one row and the first words of the next row, you must remember to allow for the 
"extra" word. 

Either DMA or programmed I/O can be used. 



Reading Full Words Using Programmed I/O 



Dkhu 200 



Nflr 



— 'i fJ:±r-fi: 
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Hut seleci 


code in i- 


Check tor- 


GRAPHICS h 
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WuRD contr 


Wait for t 


lag 


Ua. 1 c u i 3.t- e 


word addrt 


<3b*V> + : 
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RET 1 



T Crni \ 



Reading Full Words Using DMA 
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-- - Hi- 
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Operation: Cursor Operations 

Three graphics cursors are provided for your use with the graphics hardware. These are a 
non-blinking, full-screen, cross-line cursor, a small (9 pixels by 9 pixels), blinking, cross-line 
cursor, and a horizontal underline, blinking cursor. The three cursors are illustrated here — 




1 r 



horizontal cursor 



small blinking cursor 



full-screen cursor 



General Procedure: 

• An "X cursor position" command is stored in R5. 

• A value indicating the X (or horizontal) position of the cursor is sent to the hardware. 

• A "Y cursor position" command is stored in R5 (the command also identifies which cursor 
appears). 



• A value indicating the Y (or vertical) position of the cursor is sent to the hardware. 
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For most applications, only programmed I/O is used for cursor control. Thus the values 
stored in R5 should be selected from the following table — 



Cursor Type 

X cursor position 

Y position (small blinking) 

Y position (full-screen) 

Y position (small horizontal) 



Octal Control Code (to R5) 

44 
40 
41 
42 



• The data for the X coordinate must be in a special format as follows — 



15 14 13 12 II 10 9 8 7 6 


5 


4 


3 


2 


1 





ChAV 1 


— 


— 


— 


— 


— 


— 


Om A 1 



where: 

CMXl = one's complement of (X coordinate + 63) 

- = don't care 

The data for the Y coordinate must be in a special format as follows 



15 14 13 12 II 10 9 8 7 6 


5 


4 


3 


2 


1 





TMY 1 


— 


— 


— 


— 


— 


— 


^IVI T 1 



where: 

CMYl = one's complement of ( Y coordinate + 44) 

- = don't care 
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Setting the Cursor Using Programmed I/O 

The following program demonstrates the algorithm for controlling the cursor. 






40 


GCLEnR 








-••; L'i 


GRflPHICS 








60 


FRRME 








70 


INTEGER ;K,Y, 


Ti,.;r:r- 






80 


IflSSEnELE Cl 


irsor_f 


ji o 




110 


FOR Ty&8=0 ": 


2 


1 . 


SMALL. 


1 iitj 


FOR x=0 ■■- 


454 






1 -jy 


Y=X 








140 




Cursor 




,Type> 


160 


NExT~Tvjje 








i. :' '--■ 


! 








1 yy 


8 TOP 








r^0 


! 








20ti 


I SOURCE 






^iFip; : 
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I SOURCE 






E= ~ ■: 


1 


I SOURCE 

I SOURCE 
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TSi,j 
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::ri c 


320 
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ISOURCE 






LLn - 


360 


ISOURCE 
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i 
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n u 




:;" 


;— 






i 


















.\.. 




'.^ 


!... .|"- 


Ill M.i 
...J 'j 


Ill 
-...I 


ill 


'il 

1\ 


ill 


ill 


ill 

c 
...J 


'i' 


IV 

1 


.....1 


IJJ 
..!...l 


'D 




iTi 


iTi :;::: 
'"'-. ■? 


l,L,l l,i.J 


LU 


I..I.J 


i..lJ 


1,1.1 


I..I.J 


l,l..l 


l,!.J 


i..l..l 


1.1,1 


1,1.1 


I..I.J 


L1..I 


I..I..1 


1..1..1 i,.i..i 


ti:: !.>.: 


Q;: 
IJ'j 


Lt:: 

i"j 


('?i 




::i 

ifi'i 


Li: 


9;!' 
i"i"'i 


Q:: 
-~1 
c::) 
ij-.i 


LI:: 

C.'.i 


9:r 
I'S.i 


0~ 
iXi 


Ci:: 
i!"i 

Li'!i 


tt: 

iTi 


!:i- yi" 
Ci 


1— .1 I...4 


1— H 


I". H 


h-'-i 


h...i 


1--1 


i-.-^ 


1 — i 


i.....i 


1 1 


i — I 


1 1 


1-..4 


|."i 


1 1 1 1 



.I..I I..1..I I..I.I I..I.J LI..I I..I..1 I..I..I l,.l..l l.i.l I.IJ I..I..I U..I l..l.,l i..l..l I.IJ !..l..l I..IJ LjJ I..U !..!.J UJ I.J.J !.jj LlJ UJ I..L.I l.l.J I.X.1 I..I..I I.J.I LI.J I..Lt I..L.I I..I..I I.J.J i..|.J I..I.J 1..L.I i..Ll LI..I I.J.J LI..I i..l.J I..I..I I..1.J I..I.J i.i.1 i..i.J I..1.J i..l..i i.L.I 

) C.!i 

: iX': Li; ct O::: ct ct:: cx. o-s. Ol. 



l.t Lj;:. Lt LJ:: L.I::. Q: 



...1 r~t I I i..„i 



IJ .1 i.,t .1 IJ .1 



Lt u:. Lt:: Q: t'l:: lk. lk. Lt Ct Lt Or:, u:. Lt Lt tJ;:: tt iji:: \.K a:. 

ixi Ci cj Ci o cj i::ii cj ci ld Ci i:::j o cj cj cj iid czi o 
iXi I'l'i u'l i:.i':i iTi I'i'i CO CO cci o"! co co co ci':' co o'!! cci cci I'i'i 



:: LI::. I..1::. Ct: 



CJ 

IB 
a 

o 



Ci i:iii:i c:^' c-ii 1:!!^ i-j.' 1:^.1 i-w.' C:j t 
" ■'t in >:0 \'--~ iXi i::r'. c 



i.i.i i.\i C;J i\i Ci Ci i3 i.:J Citi Ci C:..' Ci liJ i.iJ Ci i-Hi C:J i.j.i i..:ti 

ir'.j C'':i Ti" uTi '-jj [■■". cc'i ij'. is -.-i i"..i cci ■^ u'^i '.ii r-- co i::i''' ci i-* c..i 



:..! i.:..! 13 Ci.1 Ci Ci Cj} 

^j" i.r:i CD [■■- oj ij-i i's.i 



•^t- i::!" rt ■.::f- ■.::r' -ri- Tf •-.f t;!- Tt 0:1 Lc:! Lfi ij":! 1.0 Lfi i.i':i i.ri Li'^i Lfi '.Li '-i^i i-.ci '-£1 '-v '■£! I.JJ '-Ii I..LI '-v r--. f-.- r--... r---. p'-. r--- r-'... r--.- r- r-. 



Ci I'ii 1^1 Ci.':! isi cii't iji:i C' C:.':i ci C;i:i ixi ci I'lj c~j c-j ixi czi 
■'-I i'-..i CO ■":j- i.|-:i i.£i p-- o::i (t-. 13 ■■■■-i im cci ■^t- ij":i Oj r-- co 

i"0 iTi Cij CO iXi iTi i:i::i co CCi O'-. O'-. n-. ir, n-, it, iT', iT. iT, 
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Line Drawing 

Lines drawn on the CRT must be drawn pixel-for-pixel between two points because the System 
45 graphics is a raster scan graphics. Line drawing routines are typically implemented in 
software and called when needed. One such routine is provided for your use on the Demonstra- 
tion Cartridge. 

The Demo Cartridge line drawing routine is contained within a file called "BRAL". To use this 
routine, simple follow the prompts which are displayed. 

A listing of the line drawing routine appears here — 

20 PRINT ••* ERESENHflM flLGORITHr-l FijR LINE TO DOT CONVERSION *''' 

40 ICOM 1000 

50 ON KEY #6 GOTO Last 

60 PRINT "Press KEYS to exit" 

70 I r-ITEGER >■: 1 , Y i , X2 , Y2 , L i pat 

30 I DELETE ALL 

90 IflSSEilBLE Modi 

100 GCLEFiR 

110 Begin: PRINT 

120 PRINT '-enter the X,Y coordinates of the 2 points, rriaxi mum K v'alue is" 

130 PRINT "559 and maximuni Y '-.-'alue is 454" 

140 INPUT Kl , Yl, X2, Y2 I Get coordinates of 2 points line will join 

150 PRINT "enter the line pattern type: eraser= 0, solid= 1" 

160 INPUT Li pat ! Get line type: solid or erase 

1 70 PR I NT " po i nt c ;oord i nat es : X 1 = ";;=■; 1 ; " Y 1 = " ; Y 1 ; " H2='' ; X2 ; " Y2= " ; Y2 

130 GRhPHICS 

190 ICRLL Drai..iC-;l , Yi ,x;2, Y2,Lipat > ! Call assembl v- routine to drai..j line 

200 ! between 2 points 

210 PRUSE 

230 GOTO Begin i Repeat drawing lines 

240 Last: END 



10-28 Graphics 



300 

310 



340 
350 

360 

330 
390 

400 

420 
430 
440 
450 
460 
470 
430 
490 

500 

510 
520 
530 
540 
550 
560 
570 
530 
590 

600 

6 10 
620 
630 

650 
660 
670 
680 

690 

700 

710 
720 
730 
740 
750 
760 
770 
780 
790 
300 
810 
820 
830 
840 
350 



SOURCE 
SOURCE 
SOURCE 



.i: 



;OURCE X2: 
iuURCE Y2: 
iOURCE Lipat 
SOURCE Da: 
iOURCE Dbb: 
SOURCE Dxy: 
URCE II: 



ISOURi 



iUUKUt Hxcnt 
iOURCE Del : 



:;uURi_:L 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
OURCE 
OURCE 
;=;nijRCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
;OURCE 
SOURCE 
;ni lh?CE 



T3 
T4; 
T5 



■ijUKL-h 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 

SOURCE 
JRCE 

URCE 
SOURCE 

URCE 
SOURCE 

OURCE 
ni !F?CF 



;OURCE 
SOURCE 



HRM 
EXT 
ESS 

ESS 



Modi 



ESS 


i 


ESS 


4 


ESS 


4 


ESS 


4 



ESS 1 
ESS 1 
DfiT 5 IE 



DAT 
DAT 
DAT 
DAT 
DRT 
DAT 
DAT 
DRT 

*+l 
DAT 
DAT 
DAT 
DAT 
SUE 
INT 
INT 
INT 
INT 
INT 
LDA 
LDE 

jsn 

LDA 
LDE 

jsn 

LDA 
LDE 
JSN 
LDA 
LDE 
JSM 
LDA 
LDE 
JSN 
LDA 
TCA 
ADA 
STA 
LDA 
TCA 
ADA 
STfl 



iOOlE 

402E 

200 1 E 

404E 

1003E 

1402E 

2003E 

1404E 



Inc: 
Inc!: 
Dec: 
Dec 



First ;■■•; coordinate 

First y coordinate 

Second H coord irhate 

Second V coord iri-ate 

L i ne t ype '. 1 =so lid, 0=erase 

Da= X2-:>a ->Delta X 

Dbb= Y2-Y1 ->Delta V 

Dx:,.'= AESCDelta X:>- AES^Delta Y 

Address of X or Y increment or 

d e c r e m en t r o u t i n e 



Adc 



of 



:>r '■(' increment 



d e c r e me n t r ou t i n f. 
Next count 
Del= (-D3.> 
Graphics command 

octant 



Dx 


Dv 


Dx 

















1 





1 








1 


1 


1 


y 





1 




i 


1 





Rddres: 
Addres: 
Addres: 
Addres: 



of X increment routii 

of Y increment rout 

of :-! iiecrement- rout, 

of Y decrement rout 1 nt 



! Uet first X coordii-iate int 



ICON 



bet first Y coordinate into ICON 



ICON 



=Ti ! 

Get value ! 

=Y1 ! 

=T2 ! 

Get__Malue ! 

=^X2 I Get second X coordiriate int. 

=T3 ! 

Let_'-..'alue ! 

=Y2 ! Get second Y coordinate int' 

=T4 ! 

Get value ! 

=LipELt ! Get line type- into ICON 

==T5 ! 

Get__'-,.'a 1 ije ! 

Yl ■ Offset origin to lower left 
! corner by subractmq Y from 

=454 ! 4:0 4 

Yl ! 



ICON 



=454 
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124i3 



-■ i' '€• 


i-r-ijsjKCti 


S80 


I SOURCE 


890 


I SOURCE 


909 


I SOURCE 


910 


I SOURCE 


920 


I SOURCE 


9 30 


I SOURCE 


940 


I SOURCE 


950 


I SOURCE 


960 


I SOURCE 


970 


I SOURCE 


^ :~ J L^ 


I SOURCE 


990 


I SOURCE 


1000 


I SOURCE 


1010 


I SOURCE 


1020 


I SOURCE 


1030 


I SOURCE 


1040 


I SOURCE 


1050 


I SOURCE 


1060 


I SOURCE 


1070 


I SOURCE 


1080 


I SOURCE 


1090 


I SOURCE 


1100 


I SOURCE 


1110 


I SOURCE 


1120 


I SOURCE 


1130 


I SOURCE 


1140 


I SOURCE 


1 150 


I SOURCE 


1 160 


I SOURCE 


1 170 


I SOURCE 


1 130 


I SOURCE 


1190 


I SOURCE 


1200 


I SOURCE 


1210 


I SOURCE 


1220 


I SOURCE 



ioOUF 

I snuF 



i2yu 


I SOURCE 


1 300 


ISOURCE 


1310 


I SOURCE 


1320 


ISOURCE 


1 330 


ISOURCE 



.370 


ISOURCE 




1 380 


ISOURCE 




1390 


ISOURCE 




1400 


ISOURCE 




1410 


ISOURCE 




1420 


ISOURCE 




1430 


ISOURCE 


Br 


1440 


ISOURCE 




1450 


ISOURCE 




1460 


ISOURCE 




1470 


ISOURCE 


JI'T" 



STR Pa 

SFC * 

LEE Glaadc 



LIiH XI 
TCH 

Hlifl K2 

STH Da 

SRP *+2 
TCR 

LDE VI 

REE V2 

STE Ebb 

SEM *+2 
i L-J:^ 

fjnfl V, 

C;Tp T{ ■...■; ; 

SRM Chs 

LDR Da 

LDE Ebb 

Jhr ErhM! 

LDR Da 

LDE Dbb 

STR Dbb 

STE Da 



HND 



iQ CiUT. gr- 
RT .=.1 '■=. 



ui!ini=ir 



RDR 


=Oct 1 


LDE 


fl, I 


LEH 


B 


RHD 


=7 


RDR 


= 11 2a 


LDR 


R, I 


STR 


1 1 


LDR 


E 


SRR 


o 


RDR 


= I12ei 


LDR 


H T 


STR 


T ■" 


LDR 


Dbb 


SAP 


rii--nrrik. 



STR Dbt 

LDR Da 

TCR 

STR Ea 

RTiR =1 



_-=L I i_ ^--1 i :! :.■ ■-■ i 



! 3tori= in Dx^.^ 
[f Dxy< then » 









; i_-=l i i_ L4 ! cH. f 



nd I; 



'-■■±L \ ■-- U i d.! 



RE:i 
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1480 


I SOURCE 




1 499 


I SOURCE 




1506 


I SOURCE 




1510 


I SOURCE 




1520 


I SOURCE 




1530 


I SOURCE 




1540 


I SOURCE 




1550 


I SOURCE 




1560 


I SOURCE 




1570 


I SOURCE 




15S0 


I SOURCE 




1590 


I SOURCE 


Loc 


1600 


I SOURCE 




1610 


ISnURCE 


Loc 


1620 


I SOURCE 




1 630 


I SOURCE 




1640 


I SOURCE 




1650 


I SOURCE 




1 66Pi 


I SOURCE 




1670 


I SOURCE 




1680 


I SOURCE 




1 690 


I SOURCE 




1700 


I SOURCE 




1710 


I SOURCE 




1720 


I SOURCE 




1730 


I SOURCE 




1740 


I SOURCE 




1750 


I SOURCE 


Old 


1760 


I SOURCE 




1770 


I SOURCE 




1 780 


I SOURCE 




1790 


I SOURCE 




1300 


I SOURCE 




1310 


I SOURCE 




1S20 


ISOURCE 




1830 


I SOURCE 




1840 


ISOURCE 




1850 


ISOURCE 




1860 


ISOURCE 


I nc 


1 870 


ISOURCE 




1880 


ISOURCE 


I nc 


1 890 


ISOURCE 




i90£i 


ISOURCE 


Dec 


1910 


ISOURCE 




1920 


ISOURCE 




1930 


ISOURCE 


T;,:;-,- 


1940 


ISOURCE 




1950 


ISOURCE 




I960 


ISOURCE 


Gda 


1970 


ISOURCE 




1980 


ISOURCE 




1990 


ISOURCE 




2000 


ISOURCE 





STR 


Hxcnt. 


LDR 


iLa 


TCR 




STR 


Del 


HllR 


Dbb 


SRL 


i 


STR 


Ha 


LDR 


Dbb 


SRL 


1 


STR 


Dbb 


LDR 


Del 


HllR 


Dbb 


STR 


Del 


LIiB 


Y I 


LDR 


— '■-'b 


MPy 




LIiB 


':■■' 1 


SER 


4 


RDR 


E 


CNR 




JSM 


Gdat-a 


LDR 


<■■. 1 


RND 


= 17E 


LDE 


L 1 pat 


SEL 


1 s 


I OR 


B 


.JSM 


Gdata 


ESZ 


Nxcnt, 


JhlP 


*+2 


RET 


i 


JSM 


T i T 
i J., i. 


LDR 


Del 


SRP 


*+2 


..IMP 


Loopa 


JSM 


12,1 


RDR 


Ha 


STR 


Del 


JMP 


Loopb 


IS2 


y, 1 


RET 


1 


ISZ 


VI 


RFT 


1 



RET 



RET 


i 


RET 


1 


SFC 


•+• 


STR 


R4 


STR 


R7 


RET 


1 


bHU 


Plo 



! Iiel= -Ha 



! Da= 2(Dbb-Da' 



Dbb=2*Db[ 



Del= -fe + Dbb 
Get word addres: 



! Send out biord address 

! Get bit address: 

! Loi.ier 4 bits are address and 

! most significant bit is uiheth 

! pixel is turned on or not 

1 

' Send out bit address 
! Decrement Nxcnt 

! Exit if Nxcnt is 

: Update y', and Y addresses 



idd 



■iUG! 'fol 



! Y address 



■out 1 nf 

■out 1 nt 



! X address decrement routine 
I 



! Y address decrement 



\ Routine to output data ti 
! R4 and R7 



Appendix i\ 

ASCII Character Set 
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ASCII Character Codes 



ASCII 
Char. 


EQUIVALENT FORMS 


Binary 


Oct 


Hex 


Dec 


NULL 


00000000 


000 


00 





SOH 


00000001 


001 


01 


1 


STX 


00000010 


002 


02 


2 


ETX 


0000001 1 


003 


03 


3 


EOT 


00000100 


004 


04 


4 


ENQ 


00000101 


005 


05 


5 


ACK 


00000110 


006 


06 


6 


BELL 


00000111 


007 


07 


7 


BS 


00001000 


010 


08 


8 


HT 


00001001 


Oil 


09 


9 


LF 


00001010 


012 


OA 


10 


VT 


00001011 


013 


OB 


11 


FF 


00001100 


014 


OC 


12 


OR 


00001101 


015 


OD 


13 


SO 


00001110 


016 


OE 


14 


SI 


ooooiin 


017 


OF 


15 


DLE 


00010000 


020 


10 


16 


DCl 


00010001 


021 


11 


17 


DC2 


00010010 


022 


12 


18 


DCS 


00010011 


023 


13 


19 


DC4 


00010100 


024 


14 


20 


NAK 


00010101 


025 


15 


21 


SYNC 


00010110 


026 


16 


22 


ETB 


OOOIOlll 


027 


17 


23 


CAN 


00011000 


030 


18 


24 


EM 


00011001 


031 


19 


25 


SUB 


00011010 


032 


lA 


26 


ESC 


00011011 


033 


IB 


27 


FS 


00011100 


034 


IC 


28 


GS 


00011101 


035 


ID 


29 


RS 


00011110 


036 


IE 


30 


US 


00011111 


037 


IF 


31 



ASCII 
Char. 



EQUIVALENT FORMS 



Binary 



00100000 
00100001 
00100010 
00100011 
00100100 
00100101 
00100110 
00100111 
00101000 
00101001 
00101010 
00101011 
OOIOIIOO 
00101101 
00101110 
00101111 
00110000 
00110001 
00110010 
00110011 
OOllOlOO 
00110101 
00110110 
00110111 
00111000 
00111001 
00111010 
00111011 
00! 11100 
00111101 
00111110 
00111111 



040 
041 
042 
043 
044 
045 
046 
047 
050 
051 
052 
053 
054 
055 
056 
057 
060 
061 
062 
063 
064 
065 
066 
067 
070 
071 
072 
073 
074 
075 
076 
077 



34 

35 

36 

37 

38 

39 

3A 

3B 

3C 

3D 61 

3E 62 

3F 63 



ASCII 
Char. 


EQUIVALENT FORMS ' 


Binary 


Oct 


Hex 


Dec 


@ 


01000000 


100 


40 


64 


A 


01000001 


101 


41 


65 


B 


01000010 


102 


42 


66 


C 


01000011 


103 


43 


67 


D 


01000100 


104 


44 


68 


E 


01000101 


105 


45 


69 


F 


01000110 


106 


46 


70 


G 


01000111 


107 


47 


71 


H 


01001000 


110 


48 


72 


1 


01001001 


111 


49 


73 


J 


01001010 


112 


4A 


74 


K 


01001011 


113 


4B 


75 


L 


01001100 


114 


4C 


76 


M 


01001101 


115 


4D 


77 


N 


01001110 


116 


4E 


78 





01001111 


117 


4F 


79 


P 


01010000 


120 


50 


80 


Q 


01010001 


121 


51 


81 


R 


01010010 


122 


52 


82 


S 


01010011 


123 


53 


83 


T 


01010100 


124 


54 


84 


U 


01010101 


125 


55 


85 


V 


01010110 


126 


56 


86 


W 


01010111 


127 


57 


87 


X 


01011000 


130 


58 


88 


Y 


01011001 


131 


59 


89 


z 


01011010 


132 


5A 


90 


[ 


01011011 


133 


5B 


91 


\ 


01011100 


134 


5C 


92 


1 


01011101 


135 


5D 


93 


" 


OlOllHO 


136 


5E 


94 


- 


01011111 


137 


5F 


95 



ASCII 
Char. 


EQUIVALENT FORMS 


Binary 


Oct 


Hex 


Dec 




01100000 


140 


60 


96 


^ 


OIlOOOOl 


141 


61 


97 


b 


01100010 


142 


62 


98 


c 


01100011 


143 


63 


99 


d 


OIIOOIOO 


144 


64 


100 


e 


01100101 


145 


65 


101 


f 


01100110 


146 


66 


102 


9 


01100111 


147 


67 


103 


h 


01101000 


150 


68 


104 


' 


01101001 


151 


69 


105 


J 


01101010 


152 


6A 


106 


k 


01101011 


153 


6B 


107 


1 


01101100 


154 


6C 


108 


m 


01101101 


155 


6D 


109 


n 


01101110 


156 


6E 


110 





01101111 


157 


6F 


HI 


P 


01110000 


160 


70 


112 


q 


01110001 


161 


71 


113 


' 


01110010 


162 


72 


114 


s 


OlIlOOll 


163 


73 


115 


i 


01110100 


164 


74 


116 


u 


01110101 


165 


75 


117 


V 


01110110 


166 


76 


118 



OIUOIU 

01111000 I 

01111001 '] 
OllllOIO 

01111011 ; 



167 
170 



172 
173 



119 
120 
121 
122 
123 



01111101 , 175 70 i 125 



DEL 01111111 177 



A-2 ASCII Character Set 



The following table gives the octal value for an ASCII character in the most significant byte 
("First Character" column) and the least significant byte ("Second Character" column) of a 
word. The diagram illustrates the positions of the first and second character positions of a word. 



First Character 



Second Character 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 






ASCII 


First Character 


Second Character 


ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 


Character 


Octal Equivalent 


Octal Equivalent 


NUL 


000000 


000000 


% 


022400 


000045 


SOH 


000400 


000001 


& 


023000 


000046 


STX 


001000 


000002 




023400 


000047 


ETX 


001400 


000003 


( 


024000 


000050 


EOT 


002000 


000004 


) 


024400 


000051 


ENQ 


002400 


000005 


♦ 


025000 


000052 


ACK 


003000 


000006 


+ 


025400 


000053 


BEL 


003400 


000007 




026000 


000054 


BS 


004000 


000010 




026400 


000055 


HT 


004400 


000011 




027000 


000056 


LF 


005000 


000012 


/ 


027400 


000057 


VT 


005400 


000013 





030000 


000060 


FF 


006000 


000014 


1 


030400 


000061 


CR 


006400 


000015 


2 


031000 


000062 


SO 


007000 


000016 


3 


031400 


000063 


SI 


007400 


000017 


4 


032000 


000064 


DLE 


010000 


000020 


5 


032400 


000065 


DCl 


010400 


000021 


6 


033000 


000066 


DC2 


011000 


000022 


7 


033400 


000067 


DCS 


011400 


000023 


8 


034000 


000070 


DC4 


012000 


000024 


9 


034400 


000071 


NAK 


012400 


000025 




035000 


000072 


SYN 


013000 


000026 




035400 


000073 


ETB 


013400 


000027 


< 


036000 


000074 


CAN 


014000 


000030 


= 


036400 


000075 


EM 


014400 


000031 


> 


037000 


000076 


SUB 


015000 


000032 


7 


037400 


000077 


ESC 


015400 


000033 


@ 


040000 


000100 


FS 


016000 


000034 


A 


040400 


COOlOl 


GS 


016400 


000035 


B 


041000 


000102 


RS 


017000 


000036 


C 


041400 


000103 


US 


017400 


000037 


D 


042000 


000104 


SP 


020000 


000040 


E 


042400 


000105 


1 


020400 


000041 


F 


043000 


000106 


" 


021000 


000042 


G 


043400 


000107 


# 


021400 


000043 


H 


044000 


000110 


$ 


022000 


000044 


I 


044400 


000111 



ASCII Character Set A-3 



ASCII 


First Character 


Second Character 


ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 


Character 


Octal Equivalent 


Octal Equivalent 


J 


045000 


000112 


e 


062400 


000145 


K 


045400 


000113 


f 


063000 


000146 


L 


046000 


000114 


9 


063400 


000147 


M 


046400 


000115 


h 


064000 


000150 


N 


047000 


000116 


i 


064400 


000151 





047400 


000117 


J 


065000 


000152 


P 


050000 


000120 


k 


065400 


000153 


Q 


050400 


000121 


1 


066000 


000154 


R 


051000 


000122 


m 


066400 


000155 


S 


051400 


000123 


n 


067000 


000156 


T 


052000 


000124 


o 


067400 


000157 


U 


052400 


000125 


P 


070000 


000160 


V 


053000 


000126 


q 


070400 


000161 


W 


053400 


000127 


r 


071000 


000162 


X 


054000 


000130 


s 


071400 


000163 


Y 


054400 


000131 


t 


072000 


000164 


Z 


055000 


000132 


u 


072400 


000165 


[ 


055400 


000133 


V 


073000 


000166 


\ 


056000 


000134 


w 


073400 


000167 


] 


056400 


000135 


X 


074000 


000170 


A 


057000 


000136 


y 


074400 


000171 


8 


057400 


000137 


z 


075000 


000172 




060000 


000140 


{ 


075400 


000173 


a 


060400 


000141 


h 


076000 


000174 


b 


061000 


000142 


} 


076400 


000175 


c 


061400 


000143 


^/ 


077000 


000176 


d 


062000 


000144 


DEL 


077400 


000177 



A-4 ASCII Character Set 



Appendix D 

Machine Instructions 



B-l 



Detailed List 



Instruction 



Form 



Group 



Description 



AAR 



ABR 



ADA 



{n} 



?{n} 



{loc}[,I] 



Shift/Rotate 



Shift/Rotate 



Integer Math 



ADB 



:Kloc}[,I] 



Integer Math 



AND 



{loc} [, I] 



Logical 



Shifts the A register right the indicated number of 
bits with the sign bit filling all vacated bit positions. 
(Arithmetic right) 

Shifts the B register right the indicated number of 
bits with the sign bit filling all vacated bit positions. 
(Arithmetic right) 

Adds the contents of the specified location to the 
contents of register A. The result is in A. If a carry 
occurs, Extend is set, otherwise Extend is un- 
changed. If an overflow occurs. Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow is a carry from bit 15 or 14, but 
not both. Extend and Overflow are bits in the pro- 
cessor. Specifying register R4, R5, R6, or R7 as 
the location causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 

Adds the contents of the specified location to the 
contents of register B. The result is in B. If a carry 
occurs. Extend is set, otherwise Extend is un- 
changed. If an overflow occurs. Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow is a carry from bit 15 or 14, but 
not both. Extend and Overflow are bits in the pro- 
cessor. Specifying register R4, R5, R6, or R7 as 
the location causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 

Logical "and" operation. The contents of the A 
register are compared, bit by bit, with the contents 
of the specified location. For each bit comparison 
a 1 results if both bits are I's, a results otherwise. 
The 16-bit result is left in A. Specifying register 
R4, R5, R6, or R7 causes an input bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 



B-2 Machine Instructions 



Instruction 


Form 


Group 


Description 


CBL 


C: ];::[.. 


Stack 


Clears the Cb register. Specifies the lower block of 
memory for byte-referencing stack instructions. 


CBU 


CEU 


Stack 


Sets the Cb register. Specifies the upper block of 
memory for byte-referencing stack instructons. 


CDC 


CDC; 


BCD Math 


Clears Decimal Carry explicitly. 


CLA 


cL.n 


Shift 


Clears register A. This is exactly equivalent to SAR 
16. 


CLB 


ClJ;; 


Shift 


Clears register B. This is exactly equivalent to SBR 
16. 


CLR 


CLR {n} 


Load/Store 


Clears the specified number of words, beginning 
at the location pointed at by the A register. A 
maximum of 16 words may be cleared. 


CMA 


CMR 


Memory 


Perform a one's complement of the A register (bit 
by bit inversion of all 16 bits). 


CMB 


CME 


Memory 


Perform a one's complement of the B register (bit 
by bit inversion of all 16 bits). 


CMX 


''-■'■'"'■ 


BCD Math 


Ten's complement of Arl. The mantissa of Arl is 
replaced with its ten's complement and Decimal 
Carry is cleared. 


CMY 


L.V\ 1 


BCD Math 


Ten's complement of Ar2. The mantissa of Ar2 is 
replaced with its ten's complement and Decimal 
Carry is cleared. 


CPA 


CPfl{loc}[,I] 


Test/Branch 


Compares the contents of register A with the con- 
tents of the specified location and skips if they are 
unequal. Indirect addressing may be specified. 
Specifying register R4, R5, R6, or R7 causes an 
input bus cycle to the interface addressed by the 
Pa register, {loc} must be on base or current page. 


CPB 


CFE{loc}[,I] 


Test/Branch 


Compares the contents of register B with the con- 
tents of the specified location and skips if they are 
unequal. Indirect addressing may be specified. 
Specifying register R4, R5, R6, or R7 causes an 
input bus cycle to the interface addressed by the 
Pa register, {loc} must be on base or current page, 
{loc} must be on base or current page. 


DBL 


DEL 


Stack 


Clears the Db register. Specifies the lower block of 
memory for byte-referencing stack instructions. 


DBU 


DEU 


Stack 


Sets the Db register. Specifies the upper block of 
memory for byte-referencing stack instructions. 


DDR 


DDR 


I/O 


Disables Data Request. Cancels the DMA 
instruction. 


DIR 


DIR 


I/O 


Disables the interrupt system. Cancels the EIR 
instruction. 


DMA 


Di-lH 


I/O 


Enables the DMA mode. Cancels the DDR 
instruction. 



Machine Instructions B-3 



Instruction 



Form 



Description 



DRS 



BCD Math 



DSZ 



riSZ{ioc}[,i] 



Test/ Alter/Branch 



EIR 



EXE 



£>^:E{reg}[,I] 



I/O 
Miscellaneous 



FDV 



FD'^ 



BCD Math 



FMP 



BCD Math 



FXA 



pyfl 



BCD Math 



Mantissa right shift of Arl for one digit. The 
twelfth digit is shifted into bits 0-3 of the A regis- 
ter. The non-digit part of the A register is cleared 
(bits 4-15), and the Decimal Carry bit in the pro- 
cessor is cleared. The first digit in the mantissa is 
set to 0. 

Decrements the contents of the specified location 
and skips if the new contents are 0. Specifying 
register R4, R5, R6, or R7 causes an input (or an 
input and an output) bus cycle to the interface 
addressed by the Pa register. Indirect addressing 
may be specified, {loc} must be on base or current 
page. 

Enables the interrupt system. Cancels the DIR in- 
struction. 

Executes the contents of a register, {reg} is an in- 
teger in the range of through 31, indicating the 
register to be used (see Memory Map for the cor- 
respondence between location and register). The 
register is left unchanged unless the instruction 
code causes it to be altered. The next instruction 
to be executed is the one following the EXE, un- 
less the code in the executed register causes a 
branch. Indirect addressing may be specified. 

Fast divide. The mantissas of Arl and Ar2 are 
added together, along with Decimal Carry, until 
the first decimal overflow occurs. The result ac- 
cumulates into Ar2. The number of additions 
without overflow is placed into the lower 4 bits of 
the B register (0-3). The remainder of the B regis- 
ter is cleared, as is the Decimal Carry bit in the 
processor. 

Fast Multiply. Performs the multiplication by re- 
peated additions. The mantissa of Arl is added to 
Ar2 along with Decimal carry, a specified number 
of times. The number of times is specified in the 
lower 4 bits (0-3) of the B register. The result ac- 
cumulates in Ar2. If intermediate overflows occur, 
the number of times they occur appears in the 
lower 4 bits of the A register after the operation is 
complete. The upper 12 bits of the A register are 
cleared along with Decimal Carry. 

Fixed-point addition. The mantissas of Arl and 
Ar2 are added together and the result placed in 
Ar2. Decimal Carry is used as the twelfth digit. 
After the addition, Decimal Carry is set if an over- 
flow occurred, otherwise Decimal Carry is cleared. 



B-4 Machine Instructions 



Instruction 



Form 



Group 



Description 



lOR 



{loc}[,I] 



Logical 



ISZ 



{loc}[,I] 



Test/ Alter/ Branch 



JMP 



JSM 



{loc}[,I] 



{loc}[,I] 



Branch 



Branch 



LDA 



H {loc} [ , I ] 



Load/Store 



LDB 



{loc} [ , I ] 



Load/Store 



MLY 



BCD Math 



MPY 



Integer Math 



Logical "inclusive or" operation. The contents of 
the A register are compared, bit by bit, with the 
contents of the specified location. For each bit 
comparison, a results if both bits are O's, a 1 
otherwise. The 16-bit result is left in A. Specifying 
register R4, R5, R6, or R7 causes an Input bus 
cycle to the interface addressed by the Pa register. 
Indirect addressing may be specified, {loc} must 
be on base or current page. 

Increments the contents of the specified location 
and skips if the new contents are 0. Specifying 
register R4, R5, R6, or R7 causes an input (or an 
input followed by an output) bus cycle to the inter- 
face addressed by the Pa register. Indirect ad- 
dressing may be specified. {loc} must be on base 
or current page. 

Unconditionally branches to the specified loca- 
tion. Indirect addressing may be specified, {loc} 
must be on base or current page. 

Jumps to subroutine. The value of the R register 
is incremented by 1 and the value of the P regis- 
ter (i.e., the location of the JSM instruction itself) 
is stored in the address pointed to by the R regis- 
ter. Execution then proceeds to the specified lo- 
cation. Return from the subroutine is effected by 
the RET instruction. Indirect addressing may be 
specified, {loc} must be on base or current page. 

Loads register A with the contents of the 
specified location. Specifying register R4, R5, 
R6, or R7 causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 

Loads register B with the contents of the 
specified location. Specifying register R4, R5, 
R6, or R7 causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 

Mantissa left shift on Ar2 for one digit. This is a 
circular shift, with the bits 0-3 of the A register 
forming a thirteenth digit. The non-digit part of 
the A register is cleared (bits 4-15), and the Dec- 
imal Carry bit in the processor is cleared. 

Binary multiply. Uses Booth's Algorithm. The 
values of the A and B registers are multiplied to- 
gether with the product placed into A and B. The 
A register contains the least significant bits and 
the B register contains the most significant bits 
and the sign. B may contain any integer within 
the range -32 767 to +32 767. 



Machine Instructions B-5 



Instruction 



fit 






MRX 



m>\ 



BCD Math 



MRY 



BCD Math 



MWA 



MnR 



BCD Math 



NOP 
NRM 



HijP 



HRN 



Miscellaneous 
BCD Math 



Mantissa right shift on Arl. The number of digits 
to be shifted is specified in the lower 4 bits (0-3) 
of the B register. The shift is accomplished in 
three stages: 

1) Bits 0-3 of the A register are right-shifted into 
Di of the mantissa, with the twelfth digit being 
lost. This is the first shift. This shift always takes 
place, even if B = 0. 

2) The digits are then right-shifted for the re- 
maining number of digits specified. The twelfth 
digit is lost on each shift (except for the last shift) 
and the vacated digits are zero-filled. 

3) Finally, the last right-shifting takes place, with 
the twelfth digit shifting into the lower 4 bits (0-3) 
of the A register. The Decimal Carry bit in the pro- 
cessor is cleared and the non-digit part of the A 
register is cleared (bits 4-15). 

Mantissa right shift on Ar2. The number of digits 
to be shifted is specified in the lower 4 bits (0-3) 
of the B register. The shift is accomplished in 
three stages: 

1) Bits 0-3 of the A register are right-shifted into 
Di of the mantissa, with the twelfth digit being 
lost. This is the first shift. This shift always takes 
place, even if B = 0. 

2) The digits are right-shifted for the remaining 
number of digits specified. The twelfth digit is lost 
on each shift (except for the last shift) and the 
vacated digits are zero-filled. 

3) Finally, the last right-shifting takes place, with 
the twelfth digit shifting into the lower 4 bits (0-3) 
of the A register. The non-digit part of the A regis- 
ter is cleared (bits 4-15), and the Decimal Carry bit 
in the processor is cleared. 

Mantissa word addition. The contents of the B 
register are added to the ninth through twelfth 
digits of the Ar2 register. Decimal Carry is added 
to the twelfth digit; if an overflow occurs, Deci- 
mal Carry is set, otherwise Decimal Carry is 
cleared. 

Null operation. This is exactly equivalent to LDA 
A. 

Normalizes the Ar2 mantissa. Up to twelve left- 
shifts of the mantissa are performed until the first 
digit of the mantissa is non-zero. If the original 
first digit is already non-zero, no shifts occur. The 
number of shifts required is stored in the first 4 
bits (0-3) of the B register. If 12 shifts are re- 
quired, the Decimal Carry bit in the processor is 
set; otherwise, the Decimal Carry bit is cleared. 
The exponent is not altered. 



B-6 Machine Instructions 



Instruction 


Form 


Group 


Description 


PBC 


PEi::{reg}[,I] 


Stack 


Pushes the lower byte (right half) of the specified 
register onto the stack pointed at by the Cb and C 
registers. Specifying register R4, R5, R6, or R7 
causes an input I/O bus cycle to the interface ad- 
dressed by the Pa register. Incrementing or dec- 
rementing of the C register can be specified. In- 
crementing is the default, {reg} must be in the 
range of through 7. The incrementing or decre- 
menting action takes place before pushing. 


PBD 


PED {reg} , D 


Stack 


Pushes the lower byte (right half) of the specified 




PEri{reg}[,I] 




register onto the stack pointed at by the Db and D 






registers. Specifying register R4, R5, R6, or R7 








causes an input I/O bus cycle to the interface ad- 








dressed by the Pa register. Incrementing or dec- 








rementing the D register can be specified. Incre- 








menting is the default, {reg} must be in the range 








of through 7. The incrementing or decrementing 








action takes place before pushing. 


PWC 


PWC {reg} , D 


Stack 


Pushes entire register (full word) onto the stack 




PNC {reg} [, I] 




pointed at by the C register. Specifying register 
R4, R5, R6, or R7 causes an input I/O bus cycle to 
the interface addressed by the Pa register. Incre- 
menting or decrementing the C register may be 
specified. Incrementing is the default, {reg} must 
be in the range of through 7. The incrementing 
or decrementing action takes place before 
pushing. 


PWD 


PWD {reg} , D 


Stack 


Pushes the entire register (full word) onto the 




PWD {reg} [, I] 




stack pointed at by the D register. Specifying 






register R4, R5, R6, or R7 causes an input I/O bus 








cycle to the interface addressed by the Pa register. 








Incrementing or decrementing the D register may 








be specified. Incrementing is the default, {reg} 








must be in the range of through 7. The 








incrementing or decrementing action taken place 








before pushing. 


RAL 


RRL {n} 


Shift/ Rotate 


Rotates the A register left the indicated number of 
bits. Bit 15 rotates into bit (left circular). 
Maximum rotation of 16 bits. 


RAR 


RflF: {n} 


Shift/ Rotate 


Rotates the A register right the indicated number 
of bits. Bit rotates into bit 15 (right circular). 
Maximum rotation of 16 bits. 


RBL 


REL {n} 


Shift/Rotate 


Rotates the B register left the indicated number of 
bits. Bit 15 rotates into bit (left circular). 
Maximum rotation of 16 bits rotated. 



Machine Instructions B-7 



Instruction 


PoriTs 


Group 


Description 


RBR 


RER {n} 


Shift/Rotate 


Rotates the B register right the indicated number 
of bits. Bit rotates into bit 15 (right circular). 
Maximum rotation of 16 bits. 


RET 


RETW 


Branch 


Returns from subroutine, {n} is added to the 
contents of the address pointed to by the R 
register. The R register is decremented by 1. This 
is, in effect, a return from a JSM instruction (see 
above), to {n} instructions following the JSM itself. 
The "usual" return is RET 1. {n} must be in the 
range of - 32 through 31. 


RIA 


RlH{adrs} 


Test/ Branch 


Skips to {adrs} if register A is not 0, then 
increments register A by 1. Extend and Overflov,' 
are not effected by the incrementing action, even 
if a carry or overflow occurs, {adrs} must be within 
— 32 and + 31 of the current location. 


RIB 


RIE{adrs} 


Test/ Branch 


Skips to {adrs} if register B is not 0, then 
increments register B by 1. Extend and Overflow 
are not affected by the incrementing action, even 
if a carry or overflow occurs, {adrs} must be within 
- 32 and + 31 of the current location. 


RLA 


RLfl {adrs} [ , S ] 


Test/ Alter/Branch 


Skips to {adrs} if the least significant bit of the A 




Q! Q f- J 1 r --1 




register is not 0. Setting or clearing the bit after the 
test can be specified, {adrs} must be within - 32 
and + 31 of the current location. 


RLE 


RLE {adrs} [,S] 


Test/ Alter/ Branch 


Skips to {adrs} if the least significant bit of the B 




RLE {adrs} [,l:] 




register is not 0. Setting or clearing the bit after the 






test can be specified, {adrs} must be within - 32 








and + 31 the current location. 


RZA 


RZfl {adrs} 


Test/ Branch 


Skips to {adrs} if register A is not 0. {adrs} must be 
within - 32 and + 31 of the current location. 


RZB 


RZB {adrs} 


Test/ Branch 


Skips to {adrs} if register B is not 0. {adrs} must be 
within - 32 and + 31 of the current location. 


SAL 


SHL {n} 


Shift/ Rotate 


Shifts the A register left the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


SAM 


SRr1{adrs}[,S] 


Test/ Alter/ Branch 


Skips to {adrs} if the A register is negative (bit 15 is 




SHM{adrs}[,r:] 




1). Setting or clearing the bit after the test can be 
specified, {adrs} must be within - 32 and + 31 of 
the current location. 


SAP 


SRP{adrs}[,S] 


Test/ Alter/ Branch 


Skips to {adrs} if the A register is positive or zero 




SAP {adrs} [,r:] 




(bit 15 is 0). Setting or clearing the bit after the test 
can be specified, {adrs} must be within - 32 and 








+ 31 of the current location. 



B-8 Machine Instructions 



Instruction 


Form 


Group 


Description 


SAR 


SflR {n} 


Shift/Rotate 


Shifts the A register right the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


SBL 


SEL {n} 


Shift/ Rotate 


Shifts the B register left the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


SBM 


SEri{adrs}[,S] 
SEM{adrs}[,C] 


Test/ Alter/ Branch 
Test/ Alter/Branch 


Skips to {adrs} if the B register is negative (bit 15 is 
1). Setting or clearing the bit after the test can be 
specified, {adrs} must be within - 32 and + 31 of 
the current location. 


SBP 


SEP{adrs}[,S] 
SEP{adrs}[,C] 


Test/ Alter/ Branch 


Skips to {adrs} if the B register is positive (bit 15 is 
0). Setting or clearing the bit after the test can be 
specified, {adrs} must be within - 32 and + 31 of 
the current location. 


SBR 


SER {n} 


Shift/ Rotate 


Shifts the B register right the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


SDC 


SDC {adrs} 


BCD Math 


Skips to {adrs} if Decimal Carry is clear. Decimal 
carry is a single bit in the processor which may 
have been set by certain arithmetic operations, 
{adrs} must be within - 32 and +31 of the cur- 
rent location. 


SDI 


SD I 


I/O 


Sets DMA inwards. Reads from peripheral, writes 
to memory. 


SDO 


SDO 


I/O 


Sets DMA outwards. Reads from memory, writes 
to peripheral. 


SDS 


SDS {adrs} 


BCD Math 


Skips to {adrs} if Decimal Carry is set. Decimal 
carry is a single bit in the processor which may 
have been set by certain arithmetic operations, 
{adrs} must be with - 32 and + 31 of the current 
location. 


SEC 


SEC {adrs} [,S] 
SEC {adrs} [,C] 


Test/ Alter/ Branch 


Skips to {adrs} if Extend is clear. Extend is a single 
bit in the processor which may have been set by 
certain arithmetic operations. Setting or clearing 
the bit after the test can be specified, {adrs} must 
be within — 32 and + 31 of the current location. 


SES 


SES {adrs} [,S] 
SES {adrs} [,C] 


Test/ Alter/Branch 


Skips to {adrs} if Extend is set. Extend is a single 
bit in the processor which may have been set by 
certain arithmetic operations. Setting or clearing 
the bit after the test can be specified, {adrs} must 
be within - 32 and + 31 of the current location. 



Machine Instructions B-9 



Instruction 


Form 


Group 


Description 


SFC 


SFC {adrs} 


I/O 


Skips to {adrs} if the Flag line is false (clear). The 
Flag line is the one associated with a peripheral on 
the current select code (pointed to by the Pa regis- 
ter), {adrs} must be within - 32 and + 31 of the 
current location. 


SFS 


SFS {adrs} 


I/O 


Skips to {adrs} if the Flag line is true (set). The flag 
line is that associated with the peripheral on the 
current select code (pointed to by the Pa register), 
{adrs} must be within - 32 and + 31 of the current 
location. 


SHC 


SHi::{{adrs} 


Test/ Branch 


Skips to {address} if CRT is scanning its raster. 

•[auress/ 1I1U3I. ue wiiiiiii —Oc. aiiu -rox ui me (.,ui- 

rent location. 


SHS 


SHS{adrs} 


Test/ Branch 


Skips to {address} if CRT is doing vertical retrace, 
{address} must be within -32 and +31 of the cur- 
rent location. 


SIA 


SIR {adrs} 


Test/Branch 


Skips to {adrs} if register A is 0, then increments 
register A by 1. Extend and Overflow are not af- 
fected by the incrementing action, even if a carry 
or overflow occurs, {adrs} must be within — 32 
and + 31 of the current location. 


SIB 


SIB {adrs} 


Test/ Branch 


Skips to {adrs} if register B is 0, then increment 
register B by 1. Extend and Overflow are not af- 
fected by the incrementing action, even if a carry 
or overflow occurs, {adrs} must be within - 32 
and + 31 of the current location. 


SLA 


SLR {adrs} [,S] 


Test/ Alter/ Branch 


Skips to {adrs} if the least significant bit of the A 




SLR {adrs} [,r:] 




register is 0. Setting or clearing the bit after the 
test can be specified, {adrs} must be within - 32 
and -1- 31 of the current location. 


SLB 


SLE{adrs}[,C] 


Test/ Alter/ Branch 


Skips to {adrs} if the least significant bit of the B 




SLB {adrs} [,S] 




register is 0. Setting or clearing the bit after the 
test can be specified, {adrs} must be within - 32 
and -1- 31 of the current location. 


SOC 


SOC {adrs} [,S] 


Test/ Alter/Branch 


Skips to {adrs} if Overflow is clear. Overflow is a 




SOC {adrs} [,C] 




single bit in the processor which may have been 
set by certain arithmetic operations. Setting or 
clearing the bit after the test can be specified, 
{adrs} must be within - 32 and + 31 of the cur- 
rent location. 
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Instruction 


Form 


Group 


Description 


SOS 


SijS{adrs}[,S] 


Test/ Alter/ Branch 


Skips to {adrs} if the Overflow is set. Overflow is a 




SiJS{adrs}[,C] 




single bit in the processor which may have been 
set by certain arithmetic operations. Setting or 
clearing the bit after the test can be specified, 
{adrs} must be within - 32 and + 31 of the cur- 
rent location. 


ssc 


SSC {adrs} 


I/O 


Skips to {adrs} if Status line is false (clear). The 
status line is the one associated with the peripheral 
on the current select code (pointed to by the Pa 
register), {adrs} must be within - 32 and + 31 of 
the current location. 


sss 


SSS {adrs} 


I/O 


Skips to {adrs} if the Status line is true (set). The 
status line is the one associated with the peripheral 
on the current select code (pointed to by the Pa 
register), {adrs} must be within - 32 and + 31 of 
the current location. 


STA 


STR{loc}[,I] 


Load/Store 


Stores the contents of the A register into the 
specified location. Specifying register R4, R5, R6, 
or R7 causes an output bus cycle to the interface 
addressed by the Pa register. Indirect addressing 
may be specified, {loc} must be on base or current 
page. 


STB 


STE{loc}[,I] 


Load/Store 


Stores the contents of the B register into the 
specified location. Specifying register R4, R5, R6, 
or R7 causes an output bus cycle to the interface 
addressed by the Pa register. Indirect addressing 
may be specified, {loc} must be on base or current 
page. 


SZA 


SZR {adrs} 


Test/Branch 


Skips to {adrs} if register A is 0. {adrs} must be 
within - 32 and + 31 of the current location. 


SZB 


SZE {adrs} 


Test/Branch 


Skips to {adrs} if register B is 0. {adrs} must be 
within - 32 and + 31 of the current location. 


TCA 


TCfl 


Integer Math 


Performs a two's complement of the A register 
(one's complement, incremented by 1). If a carry 
occurs, Extend is set, otherwise Extend is un- 
changed. If an overflow occurs, Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow occurs when complementing 
- 32 768. Extend and Overflow are bits in the 
processor. 


TCB 


TCB 


Integer Math 


Performs a two's complement of the B register 
(one's complement, incremented by 1). If a carry 
occurs, Extend is set, otherwise Extend is un- 
changed. If an overflow occurs. Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow occurs when complementing 
- 32 768. Extend and Overflow are bits in the 
processor. 
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Instruction 


Form 


Group 


Description 


WBC 


WEi::{reg}[,ri] 


Stack 


Withdraws a byte from the stack pointed at by the 




WBC {reg} , I 




Ck and C registers and places it into the lower byte 






(right half) of the specified register. Specifying reg- 








ister R4, R5, R6, or R7 causes an output 1/0 bus 








cycle to the interface addressed by the Pa register. 








Incrementing or decrementing the C register can 








be specified. Decrementing is the default, {reg} 








must be in the range of through 31. The incre- 








menting or decrementing routine takes place after 








the withdrawal. 


WBD 


WED {reg} [, D] 


Stack 


Withdraws a byte from the stack pointed at by the 




WED {reg} , I 




Db and D registers and places it into the lower byte 






(right half) of the specified register. Specifying reg- 








ister R4, R5, R6, or R7 causes an output 1/0 bus 








cycle to the interface addressed by the Pa register. 








Incrementing or decrementing the D register can 








be specified. Decrementing is the default, {reg} 








must be in the range of through 31. The incre- 








menting or decrementing routine takes place after 








the withdrawal. 


WWC 


WWC {reg} [, II] 


Stack 


Withdraws a full word from the stack pointed at by 




WWC {reg} , I 




the C register and places it into the specified regis- 






ter. Specifying register R4, R5, R6, or R7 causes 








an output 1/0 bus cycle to the interface addressed 








by the Pa register. Incrementing or decrementing 








of the C register can be specified. Decrementing is 








the default, {reg} must be in the range of through 








31. The incrementing or decrementing action 








takes place after the withdrawal. 


WWD 


WWD {reg} [,D] 


Stack 


Withdraws a full word from the stack pointed at by 




WWD {reg} , I 




the D register and places it into the specified regis- 






ter. Specifying register R4, R5, R6, or R7 causes 








an output I/O bus cycle to the interface addressed 








by the Pa register. Incrementing or decrementing 








of the D register can be specified. Decrementing is 








the default, {reg} must be in the range of through 








31. The incrementing or decrementing action 








takes place after the withdrawal. 


XFR 


?::FR{n} 


Load/Store 


Transfers the specified number of words, from the 
location starting at the address pointed at by the A 
register to the location starting at the address 
pointed at by the B register. A maximum of 16 
words can be transferred. 
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Approximate Numerical List 
Bit Patterns 



Instruction 


Bit Pattern 


NOP 

LD"/b 


15 


14 13 12 


11 


10 


9 


8 


7 


6 


5 4 3 


2 1 











^8 



































CP^/b 


% 


1 


% 














^D% 


% 


1 


7b 














ST^/b 


% 


1 1 


% 














JSM 


% 


1 













Address Field | 


AND 


% 


1 1 

















'/dSZ 


% 


1 '/d 


1 














lOR 


% 



















JMP 
EXE 

SD°/, 





1 1 


1 








































Reqister Address 1 


7, 





%IR 
























1 7d 





DMA 
























1 





DDR 
























1 1 1 





^/w*/b% 

MWA 











*/b 


















'Ad 



1 

1 




7l 7c 

1 7w 7d 






Reqister Address 





CMVx 





















7x 


1 





FXA 
XFR 




















1 


1 




















N = # of words 


CLR 
NRM 


















1 
1 


1 






1 





binarv = (n-l) 











CDC 















1 


1 


1 








FMP 







1 






















FDV 







1 
















1 


1 


MRX 







1 







1 














DRS 







1 







1 








1 


1 


MRY 







1 







1 





1 








MLY 







1 







1 





1 


1 


1 


MPY 

S^/d^/c 








1 










1 


1 
1 




7d 


1 


1 1 1 


Skip Field 


"/sVi^/b 








7b 






1 


7r 





7. 

7s 


if bit 5 is 0, then skip to(P + n), 
n = bits 0-4 


SS^/c 







1 







7c 


1 





if bit 5=1, then skip to(P-n), 


SHS/c 







1 







s, 

'C 


1 


1 




S^/b% 

RET 

TC^/b 






% 



% 








1 









1 




7s 
7s 




n=two's complement of bits 0-4 


complemented skip field 


1 





CM^/b 






% 














1 


1 





CL^/b 

A^/bR 

"/s^R 

S"/bL 

R^/bL 






% 
^B 





















7s 

1 
1 


1 



1 



1 





1 


1 1 1 








Shift Field 

in source,n = l-16 
binarv = (n- 1) 


complemented shift 



Alphabetic List 
Bit Patterns and TiininQS 



Instruction 


Bit Pattern 


Timing 


AARn 


15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 4 


3 


2 


1 





Direct 


Indirect 


1 

















1 











< — 


n- 


-1 


-^ 


n + 9 




ABRn 
ADA 


1 

DM 










1 






B/C 





1 





.0 





^ 


n- 


-1 


-^ 


n + 9 
13 


19 


<- 








address 








-^ 


ADB 


D/I 










1 


B/C 


^ 








address 








-^ 


13 


19 


AND 
CBL 


D/I 














B/C 




^ 








address 








-^ 


13 
12 


19 





1 





1 





1 











CBU 




















1 





1 


1 


1 











12 




CDC 

















1 


1 


1 


1 

















11 




CLA 


1 

















1 





1 





1 


1 


1 


1 


25 




CLB 

CLRn 

CMA 


1 



1 








1 
i. 





A 





n 

1 




1 

J. 

1 




n 

1 




1 



1 






1 


1 


1 


1 


1 


25 

6n+16 
9 




1 ^ 


n- 


-1 


^ 














CMB 


1 








1 














1 


1 














9 




CMX 

















1 








1 


1 














59 




CMY 
CPA 




D'l 















B/C 


1 











1 














23 

16 


22 


^ 








address 








-^ 


CPB 
DBL 


D/I 











1 




B/C 




^ 








address 








-^ 


16 
12 


22 










1 

















DBU 

























1 


1 














12 




DDR 




























1 1 


1 











12 




DIR 




























1 


1 











12 




DMA 




























1 














12 




DRS 

DSZ 

EIR 

EXE 

FDV 




D/I 



D/| 










1 
1 




1 




B/C 






1 










1 











1 


56 
19 
12 
8 
37+13B 


25 
14 


^ 








address 








-^ 





1 


1 















1 














1^ 




egister 




-* 


1 











1 


FMP 











1 





1 


























42+13B 




FXA 
lOR 




D. 1 















B/C 


1 





1 




















40 
13 


19 


<^ 








address 








-^ 


ISZ 


D -1 










1 


B/C 


^ 








address 








-^ 


19 


25 


JMP 


D 1 




1 





1 


B-C 


^ 








address 








-^ 


8 


14 


JSM 


D 1 













B C 


^ 








address 








-^ 


17 


23 


LDA 


D 1 













B'C 


«- 








address 








-^ 


13 


19 


LDB 
MLY 


D 1 












1 
1 


B/C 




^ 








address 








-^ 


13 
32 


19 




1 





1 


1 











I 


MPY 











1 







1 


1 








1 


1 


1 


1 


65 + 2T 




MRX 











1 







1 























62 + 4B 




MRY 











1 







1 





1 

















33 + 4B 




MWA 











































28 




NOP 














































11 




NRM 
PBCr 














1 






1 




1 
1 




1 D 


1 
1 




1 















23 + Z 
23 




■^ 


r 


-^ 


PBDr 











1 








1 


I D 


1 


1 


1 


^ 


r 


-^ 


23 




PWCr 




















1 


1 D 


1 


1 





^ 


r 


-^ 


23 




PWDr 




















1 


1 D 


1 


1 


1 


■^ 


r 


-^ 


23 





Instruction 


Bit Pattern 


Timing 


RALn 


15 


14 13 12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 





Direct 


Indirect 















1 




1 








^ 15 


-n 


_> 


25-n 




RARn 















1 




1 








<— n- 


-1 


^ 


n + 9 




RBLn 














1 




1 








^ 15 


-n 


-» 


25-n 




RBRn 
RET 
















1 






1 










<— n- 


-1 


-^ 


n + 9 
16 




«- 




skip 




-^ 


RIA 









1 











1 


^ 




skip 




-^ 


14 




RIB 









1 











1 


^ 




skip 




-^ 


14 




RLA 









1 


1 


1 


H. H 


C/S 


■^ 




skip 




-^ 


14 




RLB 









1 


1 


1 


H/H 


C/S 


■^ 




skip 




-^ 


14 




RZA 









1 














4^ 




skip 




-^ 


14 




RZB 

SALn 
SAM 









1 



1 









1 
1 




1 

H H 





C/S 


^ 




skip 




-^ 


14 

n + 9 

14 










■^ n- 


-1 


-* 


<— 




skip 




-^ 


SAP 
SARn 








1 










1 


H H 




c -s 

1 


^ 




skip 




-^ 


14 
n + 9 










<— n- 


-1 


-^ 


SBLn 
SBM 










1 






1 
1 


1 

H H 




c s 








^- n- 


-1 


-^ 


n + 9 
14 




<— 




skip 




-^ 


SBP 
SBRn 
SDC 
SDI 










1 



1 












1 
1 
1 


H H 



1 




c s 

1 
1 




^ 




skip 




-> 


14 

n + 9 

14 

12 










<— n- 


-1 


-^ 


« — 




skip 




-^ 








1 











SDO 
SDS 












1 






1 






1 




1 




















12 
14 




<— 




skip 




-> 


SEC 


1 






1 


1 





H H 


c s 


<- 




skip 




-^ 


14 




SES 


1 






1 


1 


1 


H H 


c s 


^ 




skip 




-> 


14 




SFC 









1 





1 


1 





<- 




skip 




-^ 


14 




SFS 









1 








1 





^ 




skip 




-* 


14 




SHC 









1 





1 


1 


1 


*- 




skip 




-^ 


14 




SHS 









1 








1 


1 


<- 




skip 




-^ 


14 




SIA 









1 





1 





1 


<- 




skip 




-^ 


14 




SIB 









1 





1 





1 


^ 




skip 




-^ 


14 




SLA 









1 


1 





H H 


c s 


^ 




skip 




-^ 


14 




SLB 









1 


1 





H H 


c s 


4- 




skip 




-* 


14 




SOC 


1 






1 


1 





H H 


c s 


<- 




skip 




-^ 


14 




SOS 


1 






1 


1 


1 


H H 


c s 


4- 




skip 




-* 


14 




SSC 









1 





1 


1 





^ 




skip 




-^ 


14 




SSS 
STA 




D-l 






1 

B C 








1 





«- 




skip 




-» 


14 
13 


19 


<— 








add 


ess 






-^ 


STB 
SZA 










B C 

1 


^ 








addi 


ess 






-^ 


13 

14 


19 





1 








*— 




skip 




-^ 


SZB 
TCA 




1 







1 








1 












^ 




skip 




-> 


14 
9 





















TCB 
WBCr 


1 


















1 




1 D 




1 






1 

1 















9 
23 




<— 


r 


-^ 


WBDr 















1 


1 [) 


1 




1 


1 


<- 


r 


-> 


23 




WWCr 
















1 


i I) 


1 




1 





^ 


r 


-^ 


23 




WWDr 
XFRn 


















1 


1 
1 


1 !) 




1 







1 




1 


^ 


r 


-^ 


23 
12n + 2l 




<— n- 


1 


-^ 
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Bit Patterns and Timings 



Notes on timings: 



All timings are in clock cycles. One clock cycle = 175 nanoseconds. (The clock rate is 5.7 
megahertz.) 

The symbols used to represent timing information are as follows: 

n — number of bit positions to be shifted or rotated. 

N - the current value in bits 0-3 of the instruction word. 

B — the current value in bits 0-3 of the instruction word. 

T - the total number of 0^-1 and l->0 transitions in the A register using an imaginary to the 

right of bit 0. 
Z - the number of leading zeroes in the mantissa of Ar2. If Z = 12, then the total timing is 69 

clock cycles. 

Other factors that affect timing are as follows: 

• up to 4.3% of the total processor execution time is dedicated to dynamic memory refresh. 

• The total execution time dedicated to CRT refresh is — 



Minimum 


Typical 


Maximum 


6 clock cycles 
every 1/60 sec. 
(GRAPHICS mode) 


5% 


30% 
(Full screen of alternating 
blinking, underlined or 
inverse-video characters) 



• Interrupt response depends upon certain hardware and software considerations. The 
processor must be enabled with an EIR instruction. The operating system is allowed to 
disable interrupts for up to 100 /us during various operations. A fast handshake transfer 
locks out interrupts until the transfer is complete. The processor must complete the cur- 
rently executing instruction before acknowledging an interrupt. 



• Add two clock cycles to the instruction execution time if an interrupt is pending. Software 
overhead involved in getting to a user interrupt service routine consitutes a delay of 
approximately 50 fis to get to the service routine and 50 ^ts to return from the service 
routine. These delays can be lengthened by the effects of DMA, CRT refresh and m.emory 
refresh. 
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The processor locks out the initiation of a DMA transfer for a minimum of two clock cycles 
and a maximum of 64 clock cycles. The times involved for DMA transfers are - 

DMA read = 3 + (lOn + d) + lockout time 
DMA write = 3 + {9n + d) + lockout time 

where n is the number of words transferred and d is the dual-port conflict time (0 = no 
conflict... 5 = continuous conflict). Since DMA transfers take priority over instruction 
execution, these transfers can take up to 100% of the processor time, depending on the 
data transfer rate of the peripheral device. The worst case involves data transfers to and 
from a high-speed, hard disc. 

Due to bus conflicts resulting from two processors requesting one bus, processor interfer- 
ence can affect timing. If a background program is executed entirely from the ICOM 
region, processor interference does not come into play. This is the typical case. The worst 
case involves executing a BASIC program simultaneously with an ISR. In this case, pro- 
gram execution time can be as much as doubled. 
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Pseudo-Instructions 



C-l 



The following tabic lists the available assembler pseudo-instructions with a short description of 
each. 



Instruction 


Form 


Description 


ANY 


RHY 


Specifies a common or subroutine 
declaration to be any type 


BSS 


ESS {expression} 


Reserves a block of memory 


COM 


COil 


Preface for assembly language common 
declarations 


DAT 


DhT {expression} [ , {expression} [,...]] 


Defines data generators 


END 


END {name} 


Designates the end of a module 


ENT 


ENT {symbol} [, {symbol} [,...]] 


Identifies entry points in the module 


EQU 


EQU {expression} 


Defines a symbol 


EXT 


EXT {symbol} [, {symbol} [,...] ] 


Identifies external entry points 


FIL 


FIL 


Specifies a subroutine declaration to be a 
file number 


HED 


HED {comment} 


Source listing control for top-of-page with 
change of heading 


IFA 


IFH 


\ 


IFB 


IFB 




IFC 


IFC 




IFD 


IFD 




IFE 


IFE 


> Beginning of conditional assembly 


IFF 


IFF 




IFG 


IFG 




IFH 


IFH 




IFP 


IFP {numeric expression} 


> 


INT 


INT [ ':>> ] 


Specifies a common or subroutine 
declaration to be an integer 


lOF 


I OF 


Turns off automatic indirection by 
the assembler 


ION 


ION 


Turns on automatic indirection by 
the assembler 


LIT 


LIT {expression} 


Reserve memory for literals and links 


LST 


LST 


Source listing control for enabling the 
listing 
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Instruction 


Form 


Description 


NAM 


HflM {name} 


Designates the beginning of a module 


REL 


REL [ <*) ] 


Specifies a common or subroutine 
declaration to be full-precision 


REP 


REP {expression} 


Repeats instructions 


SET 


SET {expression} 


Defines a symbol 


SHO 


SHij [ <*> ] 


Specifies a common or subroutine 
declaration to be short-precision 


SKP 


■-;!-:■■ p 


Source listing control for top-of-page 


SPC 


SPC {integer expression} 


Source listing control for printing blank 
lines 


STR 


STR [ (*> ] 


Specifies a common or subroutine 
declaration to be a string 


SUB 


SUB 


Preface for a subroutine entry point 
Contains actual number of parameters 
passed by ICALL statement 
after assembly. 


UNL 


UHL 


Source listing control for disabling the 
listing 


XIF 


XIF 


End of a conditional-assembly block 
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Appendix LJ 

Assembly Language 
BASIC Language Extensions 

Formal Syntax 



The following is an alphabetical list of the BASIC Language extensions provided by the Assem- 
bly Language ROMs. 

Assembled Location 

{symbol} [ , {BASIC numeric expression} ] 
{expression} [ , {BASIC numeric expression} ] 

where: 

{BASIC numeric expression} serves as a decimal offset from the given label or constant. 

{symbol} is an assembly location. It may be either a label for a particular machine instruc- 
tion (in which case the address of the associated instruction is used), or an assembler- 
defined symbol (in which case the associated absolute address is used), or a symbol 
defined by an EQU instruction (in which case the associated value is used). 

{expression} may be a numeric expression or a string expression. If numeric, a decimal 
calculation is performed and the result is interpreted as an octal value; if the result is not 
an octal representation or an integer, an error results. If a string expression is used, the 
string must be interpretable as either an octal integer constant or a known assembly 
symbol (see {symbol} above). 

DECIMAL Function 

DECIMflL < {BASIC numeric expression} > 

lADR Function 

IflDR < {assembled location} > 
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lASSEMBLE 

IflSSEMBLE {module} [ , {module} [ ,...]][ ; {option} [, {option} [ . ...] ] ] 
IRSSEMELE ChLL] [ ; {option} [ , {option} [ , ...] ] ] 

where {module} is the name of an existing module in the source program. 

{option} may be any of the following: 



INhS {numeric expression} 

1ST 



IBREAK 

lEREHK [ DflTH ] {address} [ ; {counter} ] [ CALL {subprogram} ] 
lERERK [DflTH] {address} [ ; {counter} ][ GOSUE {line identifier} ] 
lEREflK [ DflTH ] {address} [ ; {counter} ] [ GOTO {line identifier} ] 
lEREflK ALL [ CflLL {subprogram} ] 
lEREflK ALL [ GOSUE {line identifier} ] 
lEREAK ALL [ GOTO {line identifier} ] 

where: 

{address} is an assembled location. 

{subprogram} is the name of a BASIC subprogram. 

{counter} is a numeric expression. 

{line identifier} is a line in the BASIC program. 

ICALL 

I CALL {routine} [ < {argument} [ , {argument} [ ,...]] ) ] 

where {routine} is the label associated with a SUB pseudo-instruction sequence and {data 
item} takes on the same forms and attributes as parameters in BASIC'S CALL statement. 
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ICHRHbE {assembled location} I U {octal expression} 

ICOM 

I CON {integer constant} 

IDELETE 

IDELETE {module} [ , {module} [ ;= ...] ] 

:te[hll] 



where {module} is the name of an existing module in the ICOM region. 

IDUMP 

I riUMF= {location} [ ? {location} [ ;...]] 

where {location} has the following syntax: 

[ {mode selection} ] {address} [TO {address} ] 

with {address} an assembled location and {mode selection} taking on any of the 
following forms — 

for ASCII character representation 
for binary representation 
for decimal representation 
for hexadecimal representation 
for octal representation 

ILOAD 

I LOAD {file specifier} 

where {file specifier} is of the same form as elsewhere in BASIC (see Mass Storage 
Techniques manual, or Operating and Programming manual). 

IMEM Function 

{assembled location} > 
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INORMAL 

IHORMflL [ {address} ] 

where {address} is an assembled location. 
IPAUSE OFF 

IPAUSE ON 

ISOURCE 

I SOURCE {source line} 

where {source line} may take either of the following forms — 

[ {label} : ] {action} [ ! {comment} ] 
[ {label} ° ] ! {comment} 

and: 

{label} is of the same form as elsewhere in BASIC; 

{action} is a machine instruction, pseudo-instruction, or data generator; 

{comment} is any combination of characters 



ISTORE 



'S i ORE {module} [ , {module} [ , ...] ] ^ {file specifier} 
STORE [HLL]; {file specifier} 



where: 

{module} is the name of a module currently existing in the ICOM region. 

{file specifier} is of the same form as elsewhere in BASIC (see the Mass Storage 
Techniques manual or the Operating and Programming manual). 

LITERALS 

- {expression} [, {expression} [,...]] 
{expression} may be absolute or relocatable 

OCTAL Function 

iL < {numeric expression} > 
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Predefined Assembler Symbols 



The assembler has predefined a number of symbols and has reserved them as references to 
special locations in memory. Each of these locations has a special meaning and function. You 
may not redefine these symbols. They are — 



Name 


Description 


A 


Arithmetic accumulator 


Arl 
Ar2 


} BCD arithmetic accumulators 


B 


Arithmetic accumulator 


Base page 


Base page temporary area (9 words) 


C 


Stack pointer 


Cb 


Block bit for byte pointer in C(most significant bit of address 13B) 


D 


Stack pointer 


Db 


Block bit for byte pointer in D(second most significant bit of address 13B) 


Dmac 


DMA count register 


Dmama 


DMA memory address register 


Dmapa 


DMA peripheral register (lower 4 bits of address 13B) 


End isr high 


1 


End isr low 


I Reserved symbols for use with interrupt service routines 


Isr psw 


1 


Oper_l 
Oper_2 


> Arithmetic utility operand address registers 


P 


Program counter 


Pa 


Peripheral address register (lower 4 bits of address IIB) 


R 


Return stack pointer 


R4 


' 


R5 
R6 


? I/O registers 


R7 


1 


Result 


Arithmetic utility result address register 


Se 


Shift-extend register 


Utlcount 


\ 


Utlend 


Reserved symbols for writing utilities 


Utltemps 


■ 



Each predefined symbol references a particular location in memory, except for the Utlend 
symbol, which refers to an execution address of a system routine. A graphical representation of 
these locations, plus others of interest, is presented on the next page. 
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address* 




address* 



37 

40 

min=41 



max 
77756, 

17171 
100000 



177557 
177560 



177627 
177630 



177644 
177645 



177655 
1 77656 

177657 

177660 

177661 
177665 

177666 

177767 
177770 



177773 
177774 



177777 



CPU 
registers 



(reserved) 
(at least 1 word) 



user data 
(ICOM area) 



(reserved) 
(at least 17io words) 



(reserved) 



Return stack 



(reserved) 



Base_page 



Oper 1 



Oper 2 



Result 



Utitemps 



Uticount 



(reserved) 



Arl 



(reserved) 



\ 
\ 
-starting address 

dependent upon 
system needs 



-address 
dependent upon 
starting address 
and length 
of ICOM 



Cb, 



Db- 



R4 



R5 



R6 



R7 



(reserved) 
I I I 



Pa 



(reserved) 



Dmapa 



Dmama 



Dmac 



Ar2 



T-i — T" 
Se 



(reserved) 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 



37 



*in octal representation 



Utility Name 


LDA with: 


LDB with: 


Exits 


Other 


Description 


"Minimum R-stack Entries" 


Busy 


address of 
bit pattern 


address of 
parameter 


RET 1 




Retrieves busy bits for a BASIC variable 


2 


Error exit 


error 


N/A 


None — returns to 




Aborts execution of ICALL statement. 


5 




number 




BASIC 




setting an error number 


Get bytes 


address of 
storage area 


address of 
parameter 


RET 1 


Storage area consists of: 
1st word — starting byte 
2nd word — number of bytes to be 

transferred 
3rd word on — sufficient space 

for string 


Accesses substrings (or parts of arguments) 


2 


Get elem bytes 


address of 


address of 


RET 1 


Array info obtained by Get info 


Same as "Get bytes" used for accessing elements 






storage area 


array info 




utility. Relative element number 


of string arrays 


2 










must be stored in array pointer 












(word 16) of array info. 














Storage area same as in Get bytes. 






Get file info 


address of 


file 


RET 2 — normal 


Storage area contents after return: 


Accesses a file-pointer 






storage area 


number 


RET 1 — file unassigned 


word - lower 16 bits of file address 
word 1 - number of defined records 
word 2 - current record number 
word 3 - current word in current record 




2 










word 4 - size of defined record 












word 5 - mass storage unit specifier 














word 6 - buffer address 














word 7 - check read (O = off, 1 =on) 














word 8 - high 7 bits of file address 














word 9 - (reserved by system) 






Get info 


address of 


address of 


RET 1 


Storage area must be at least: 


Returns the characteristics of a variable 






storage area 


array info 




3 words — simple variables 


passed as a parameter or existing in common 


3 










18 words — arrays 












for arrays, add 3 words for each 64K 














bytes in your machine's memory 






Get element 


address of 


address of 


RET 1 


Array info obtained by Get info 


Same as "Get value", used for elements in 






storage area 


param.eter 




utility. Relative element number 
must be stored in array pointer 
(word 16) of array info. 
Storage area must be sufficient 
size to hold value. 


an array 


2 


Get value 


address of 
storage area 


address of 
parameter 


RET 1 


Storage area must be sufficient 
size to hold value 


Returns the value of a BASIC variable 


2 


Int to rel 


N/A 


N/A 


RET 1 


Load address of integer into 
Oper 1 and address of storage 
area into Result. Storage area 
must be at least 4 words. 


Data type conversion from 
integer to full-precision 


2 


Isr access 


address of 


select code 


RET 1 — linkage not 


select code is 0-7 for low-level or 8-15 for 


Establishes linkages for interrupts 






ISR 


in bits 0-3; 
access 
code in 


established for 
reason found in 
register A: 


high-level; resource code is: 

— no resources 

1 — asynchronous access 










bits 4-5: 


- 1 = resources 


2 — asynchronous access with DMA 




5-t-u* 






trial 


unobtainable 


3 — synchronous access 










counter 


- 2 = select code 


trial counter is number of attempts before 










bits 8-14 


linked to 
another ISR 
RET 2 — normal 


aborting (RET 1, with A set to - 1) 






Mm read start 


address of 




RET 1 — memory overflow 


Mass storage descriptor is 3 words containing: 


Prepares to read a physical 






mass storage 


N/A 


RET 2 — normal 


word 1 — mass storage unit specifier 


record from mass storage 


5^u* 




descriptor 




(A contains mass 
storage transfer ID) 


word 2 — least significant 16 bits of record number 
word 3 — most significant 7 bits of record number 






Mm read xfer 


mass storage 


address of 


RET 1 — transfer incomplete 


Storage area must be at least 128 words 








transfer ID 


storage area 


RET 2 — transfer complete 


Mass storage transfer ID would be returned 




5^u* 








(A contains 0. or 


from Mm read start utility. 










error number encountered 


Storage area receives transferred information 


Reads a physical record from, m.ass storage 










during transfer) 









Utility Name 


LDA with: 


LDB with: 


Exits 




Mm write start 


address of 


address of 


RET 1 — memory overflow 


Mas: 




mass storage 


storage area 


RET 2 — normal 


Stor 




descriptor 




(A contains mass 
storage transfer ID) 


inf. 


Mm write test 


mass storage 


N/A 


RET 1 — transfer incomplete 


Mas 




transfer ID 




RET 2 — transfer complete 
(A contains 0, or error 
number encountered 
during transfer) 


Mn 


Printer select 


select-code 


printer 
width 


RETl 
(A contains previous 
printer select code; B 
contains previous printer 
width) 




Print no If 


address of 


N/A 


RET 1 — memory overflow 


Strir 




string 




RET 2 LSTOLJ pressed 
RET 3 — normal 




Print string 


address of 


N/A 


RET 1 — memory overflow 


Strir 




string 




RET 2 LII2D pressed 
RET 3 — normal 




Put_bytes 


address of 
storage area 


address of 
parameter 


RETl 


Stor 


Put elem bytes 


address of 
storage area 


address of 
array info 


RETl 


Sam 


Put element 


address of 
storage area 


address of 
array info 


RET 1 


Sam 


Put file info 


address of 


file 


RET 1 — file unassigned 


Sarr 




storage area 


number 


RET 2 — normal 




Put value 


address of 
storage area 


address of 
parameter 


RETl 




Rel math 


number of 


execution 


RETl 


Add 




operands 


address 


(A contains 0, or an error 
number) 


Ope 

into 
area 
isfo 


Rel_to_int 


N/A 


N/A 


RETl 

Overflow bit may be set 


Add 
com 
inO 
area 


Rel to sho 


N/A 


N/A 


RETl 


Add 








Overflow bit may be set 
(A contains error number) 


com 
Ope 
area 
shot 


Sho to rel 


N/A 


N/A 


RET 1 


San- 


To system 


N/A 


N/A 


RETl 


Use 
to p 



(Be sure to save the r ontents of valuable processor registers before calling a utility. 



Utility Name 


LDA with: 


LDB with: 


Exits 


Other 


Description 


"Minimum R-stack Entries" 


Mm write start 


address of 
mass storage 
descriptor 


address of 
storage area 


RET 1 — memory overflow 

RET 2 — normal 
(A contains mass 
storage transfer ID) 


Mass storage descriptor same as in Mm read start. 
Storage area must be at least 128 words and contain 
information to be transferred 


Writes a physical record to mass storage 


5 + u* 


Mm write test 


mass storage 
transfer ID 


N/A 


RET 1 — transfer incomplete 
RET 2 — transfer complete 
(A contains 0, or error 
number encountered 
during transfer) 


Mass storage transfer ID is returned from 
Mm write start utility. 


Verifies a physical record was 
written to mass storage 


5 + u* 


Printer select 


select-code 


printer 
width 


RETl 
(A contains previous 
printer select code; B 
contains previous printer 
width) 




Changes or interrogates select-code 
for standard printer 


1 


Print_no_lf 


address of 
string 


N/A 


RET 1 — memory overflow 
RET 2 Ul°iJ pressed 
RET 3 — normal 


String must be in same for as standard string. 


Gives the operating system a chance to complete 
I/O operations 


5 + u* 


Print string 


address of 
string 


N/A 


RET 1 — memory overflow 
RET 2 LilSiJ pressed 
RET 3 — normal 


String must be in same form as standard string 


Outputs a string to the standard printer 


5 + u* 


Put_bytes 


address of 
storage area 


address of 
parameter 


RET 1 


Storage area same as Get bytes 


Replaces substrings (or parts of arguments) 


2 


Put elem bytes 


address of 
storage area 


address of 
array info 


RETl 


Same as Get elem bytes 


Same as "Put bytes", used for accessing elements of 
string arrays 


2 


Put element 


address of 
storage area 


address of 
array info 


RET 1 


Same as Get element 


Same as "Put value", used for elements in an array 


2 


Put file info 


address of 
storage area 


file 
number 


RET 1 — file unassigned 
RET 2 — normal 


Same as Get file info 


Manipulates a file-pointer 


2 


Put value 


address of 
storage area 


address of 
parameter 


RETl 




Changes the value of a BASIC variable 


2 


Rel_math 


number of 
operands 


execution 
address 


RET 1 
(A contains 0, or an error 
number) 


Address of first operand into 

Oper 1 and address of second operand 

into Oper 2. Address of result 

area into Result. Execution address 

is for the desired routine. 


Provides access to all the arithmetic routines 


5 + u* 


Rel_to_int 


N/A 


N/A 


RETl 

Overflow bit may be set 


Address of the value to be 
converted should be stored 
in Oper_l, address of storage 
area of integer into Result 


Data type conversion from full-precision to integer 


2 


Rel to sho 


N/A 


N/A 


RETl 
Overflow bit may be set 
(A contains error number) 


Address of the value to be 
converted should be stored in 
Oper_l; address of storage 
area for converted number 
should be stored in Result 


Data type conversion from full-precision to short 


3 


Sho to rel 


N/A 


N/A 


RET 1 


Same as Rel to sho 


Data type conversion from short-precision to full 


2 


To system 


N/A 


N/A 


RETl 


Used within a loop, executed as many times as lines 
to print. Expedites printing process. 


Outputs string to standard printer without carriage- 
return linefeed sequence. 


5 + u* 
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Utilities 



(Be sure to save the rontents of valuable processor registers before calling a utility. 



*u = the number of levels of JSMs called by the user immediately after the utility is invoked. 
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Appendix \3 

Writing Utilities 



A utility is a "special" assembly language subroutine. What makes it special is a set of instruc- 
tions which keeps it from being displayed when a program is being stepped through using the 
lH^ key. By creating a utility, you can make your STEP actions in debugging simpler. If you 
already know what a section of code does, and don't want to have to step through each 
instruction in that section each time it is encountered, you can make it into a utility. Then, 
whenever it is encountered, the section is stepped through as if it were a single statement. The 
stepping of programs is explained in Chapter 8, Debugging. 

The following must be done to make a section of code into a utility — 

1. The entry point for the utility must consist of the instruction — 



2. Each exit point from the utility must consist of the following instructions — 



n (n may be any number, — 32 through + 31, depending upon the desired 
returning point) 



For example, here is a simple utility 



20 1 


T om ipr 


E 


1 r:rHpi_ 


_■"■'=■-••- 


1 1 1 


JZ'O-I' 


i 










4U 


isnuRC 


E 


Jser. 






ISZ 


Ut. 


;- -:l :r-,r 




1 1 It •= ■ 


if.: iT 


58 


ISOURC 


iZ. 








LDn 


Tpr 


\ij resu 


1 1. 


1 




C'Q 




b. 








SRL 


1 






1 f. 


.>-.3Jnp \ 


7fi 


I SOURC 


E 








STH 


Tpr 


■ip resu 


1 1 


1 




38 


ISLURC 


E 








Tr:-;7 


Ut. 


count 








58 


ISuURC 


t. 








RET 


i 






! Ut - 


1 i t y 


188 


ISOURC 


E 








TQpi 


ut. 


end 








:i:f 












= 













G-2 Writing Utilities 



The locations Utltemps, Utltemps + 1, Utltemps + 2, Utltemps + 3 and Utltemps+4 are available 
to you for temporary storage. The absolute addresses of these locations are 177661 through 
177665. The locations can be used at any point in your assembly language routine but are most 
convenient for use within utilities. 

System utilities also use the Utltemps locations. If you are calling system utilities from your own 
utilities, the Utltemps locations should be saved before the system utility call or avoided al- 
together. 

The Utltemps locations as well as the locations Oper_l and Oper_2 cannot be stepped 
through for debugging purposes. 

It is not required that a utility actually be a subroutine. It may also be in-line code by replacing 
the RET with JMP* -1-2. 

Utilities, and calls to utilities, are not allowed in interrupt service routines (ISRs). 
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I/O Sample Programs 



Handshake String Output 



'~'Li 


! ihlfe FKUbRHhl OUTrU 1 S H blRI 


Nb USlNb HhNDSHAKE lU H brlu-LlKE iNihRFflUt 




! IHTERFflCE CARDS flPPLICRBLE 


ARE^ 


4y 






PjCi 


i 98032 16 BIT PhRhLLEL 




fafci 


I 93835 REAL TIME CLOCr 




HCH 




E 


90 


IDELETE ALL 




100 


I COM 1000 




1 1 R 


BIN Input.*Ll60j 


1 ALLOW FOR 160 CHARflCTER STRING 


llilM 


INTEGER Select, rode 


I BASIC VARIABLE TO HOLD THE SELECT 0= 


130 


I ASSEMBLE 




140 


INPUT ■■ SELECT CODE TO WRITE T 


0?", Select code 


1 -Z'kj 


Input: L INPUT "STRING TO WRIT 


E?". Inputs i fiSK USER FOR STRING TO OUTPUT 


1H0 


TnAM^0ut.put_gpicJ.sO3elect_c 


ode, input*.-' 


190 






~" -' '"■ 


|0URCE ^_^__^ ._^_.il 


GT::iTS::Wrirj..n^^^^^^^ ^„ ^^, ^ ^^^ ^^^^ ^^ 


230 


I SOURCE StringT BSS 


81 ! RESERVED FOR 160 CHAR STR 


240 


iyuUKL-t Ur"" LUU 


13 ,i EQUATES FOR CR--LF 


dZiti 


I SOURCE Lf: EQU 


10 


ill fey 


IsnUKULi I 




2?0 


I SOURCE ! ROUTINE TO OUT 


PUT A STRING FOLLOWED BY CR-^-LF TO A GPIO-LI 


280 


I SOURCE i INTERFACE USIr 


|- lJAK4T!sMftk-'P 


ii!90 


I SOURCE ! 




300 


ISOURCE \ ENTRV POINT: 


OUTPUT gpio hs 


310 


I SOURCE ! 




■J'cHi 


ISOURCE 1 PRRflMETERS: 1 


> INTEGER CONTAINING SELECT CODE < 1 TO 14 


O ~;|7i 


ISOURCE I 2 


) STRING TO BE OUTPUT 


340 


ISOURCE I 




350 


ISOURCE i POSSIBLE ERROF 


S: 19 SELECT CODE OUT OF RANGE 


360 


ISOURCE ! 


164 CARD OR PERIPHERAL DOWN 


'~',7Ci 


ISOURCE ! 




380 


ISOURCE SUE 




400 


ISOURCE Par-ni_sc : INT 




410 


I SOURCE Out put_gp i oj'is: 


LDA ^Select code \ GET THE SELECT CODE FARM 


420 
430 


ISOURCE JSM 


Get_^.'a1ue 


440 


ISOURCE LDH 


Select code ! COPY TO PA 


450 


ISOURCE STH 


K-B. 


460 


ISOURCE ADA 


= -1 i CHECK FOR VALID RANGE Q- 


470 


ISOURCE SHM 


Sc error 


480 


ISOURCE ADR 


=-15+1 


490 


ISOURCE SAM 


Sc ok 


500 


ISOURCE Sc error: LDH 


=19 ! GIVE ERROR 19 IF SELECT 



H-2 I/O Sample Programs 



?hN 



540 



^48 






■'■;± I Ut 
ir-iG+1 



shl 



'R C 



-I'il -L 



ISOURCE 






I SOURCE 










ISOURCE 






ISOURCE 


" 


JEROUTIHE 


ISOURCE 




Qi-iHpiqrT 


ISOURCE 







SIR I 


r-j Lji 


_Eh 


GTH 


L y 


ZERO 


ERE 


TC 


-•■iOT 


HIHG 


TC 


i D0 = 




T ="• 


^RR 


FOR 


OL 


TPl \T 


THE 


CHR 


ppr 


TER 


7 m 


CRRl! 


DONE 












Khh 


ERT 










PUT 


OR-'' 


p 









ffl R4 






! 


KEIUKN iU EnSlC 


HRRRC 


TPP TO GPIO-LIKE CHR 


H 




i 


SKIP IF CRRIi IS DOW 


! 


ELSE WRIT FOR CRRD 




OUTPUT DRTR TO CRRD 


: 


TRIGGER HRUDSHRKE 


1 


^.^-r-:^r,^ pppnp iP4 rn 



W Output 
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Handshake String Input 



! IHIS PROGS 


fir 


1 IHPUlS H SiRIHb L 


1 TMTFPFRrF 


CHPDS HPPLlCflELE ARE 


i yyyji::: 




16 BIT PflRflLLEL 


1 9Si333 




BCD 


: 93035 




REAL TIME CLOCK 


! ySS36 




SERIAL INTERFACE 


IDELETE ALL 






DIM Input. *C1 


f,'r 


:i] 


INTEGER Selt 


r- 


. code 


InSSEMELE 






TMpi u -'P^Pi Pj" 


T 


CODE TO READ FROM' 






I'-zi'-J QrJ : 



its 



iSuUKCE 




NAM 


bpio inpLit 




^fOURCE 


Q^-1:=.-t --:n-. 


ENT 


net._Malue,Put_.,aM. 


IpsppyFTi'Tn HOi T\ SFI EOT fr 


lAniiPnF 


Str-inq^ 


BSS 


i-i 1 I 


RESERVED FOR 160 CHAR STR] 


I SOURCE 


C-r"' 


H yu 


1-3 '■ 


EQUATES FOR CR-^-LF 


i^C;n| ipfiF 


L+ > 


tuu 


10 




I SOURCE 










lyUUKUh 


1 ROUTINE T 


INF 


1JT A STRING FOLLOl 


iED By LF from a GP 10 -LIKE 


1 Oi„!L.= r:.=_.u. 


! INTERFACE 


- 






I SOURCE 


: A ilfi;::; OF 


160 C 


HAR ALTERS WILL BE 


READ= CR-S ARE IGNORED^ 


ItiUUKUt 










ISOURCE 


t pMTPV Pfi T 


~JT ' 


READ_qpio 




lyUUKCE 


i 








ISOURCE 


\ PARAMETER 


S; 1 


y INTEGER CONTAIf 


■iING SELECT CODE •■■ 1 TO 14 


ISOURCE 


! 


;; 


> STRING TO HOLD 


ppc;| 11 T 


lyUUKL-L 


: 








ISOURCE 


: PUyyii'Lt 


ERROF 


S: 19 SELECT COI 


IE OUT OF RANGE 


ISOURCE 


1 




164 CARD OR PE 


IRIPHERAL DOWN 


i-iUUKUt 


! 








ISOURCE 




SUE 






ISOURCE 


Pariu sc ; 


TNT 






!SuS:l 


Ppi,!T~nruA: 


LDA 


:=Select code 


|-PT THF F;Fi FCT miiF PfiPM 


ISOURCE 




LDB 


=Par-m -SC 




lyUUKL-fc. 




LDA 


!":Vjf ^i^:_,,. : 


ffipv Tn PS 


ISOURCE 




C;TH 


Ka 




ISOURCE 




ADA 


= -1 ! 


CHECK FOR VALID RANGE <1-: 


;!;:J-gCE 




ADA 


=^r^Vi "' 




lyUUKUL 


c:,- ^.,..,-.,..^.-. . 


Sfln 


-?p;"'' i 


GIVE ERROR 19 IF SELECT CC 


ISOURCE 




•JSM 


trT'Or"' e!:< 1 t ! 


IS OUT OF RANGE 


ISOURCE 


! 








ISOURCE 


Sc ok ', 


LDA 


=0 ! 


INITIALIZE THE STRING LENC 






LDA 


ist.rina ! 


SET UP C TO PUT BYTES INTl 


ISOURCE 




SAL 


1 1 


THE STRING 
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640 



HDH =1 



OURC 



jiJRi' 



jurce 
jurce i 



SSC Card down 


! SKlr Ih CHKJJ.--'h'LKlrH RRE Du 


SFC *--i 


I ELSE WRIT FOR CRRD 


LDfi R4 


! SIGHRL THIS IS RH INPUT 


STR R? 


! TRIGGER THE INPUT HRNDSHRK 


OPj-; ^ 


! WRIT FOR CRRD TO COMPLETE 


LDR R4 


i THEN GET THE EVTE 


CPR =Lf 


! IF LINE FEED 


_ ^ ^ -_ _. 


, -p. . - ^ — ^~.. T- ~ 


-j I'll"' i'On8 


: 1 hcN Wc iHKc. uUtit. 


CPR -Cn 


! IF CHRRIRGE RETURN 


.JMP Read 1 oof:' 


i THEN IGNORE IT 


PEC H, I 


! ELSE PUT CHRRflCTER IN STR I 


LDR String 


! AND BUMP STRING LENGTH 


htih =1 





\h Strinq 



JbM f-'ut- ^.-al ue- 



OR =164 



HU i i Hth Kt^ 



RETl 



Er^D 
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Interrupt String Output 



! iHIi;; PROukF 


iM OUiPUiS n SIRING USING INiLRRUPi TO ft GP 10 -LIKE IHTbRFHCL 


INTERFACE C 


:hRDS HPPLICflELE ORE = 


1 QSfi3v 


15 HIT PflRRLLEL 


: 98036 


SERIAL INTERFACE < INTERRUPT ENAELE BYTE SHOULD BE CHANGED: 


I DELETE ALL 




DIM Insut^Ll^ 


-0] : ALLOW FOR ISO CHARACTER STRING 


IRcSSoi f'^"'" 


t._code 1 BASIC VflRIRELE TO HOLD THE SELECT C 


Tf-ipi IT --QFi F!":l 


CODE TO WRITE T0?^% Select code 


OH INT #Seis.: 


t_code GOTO isr_done ^ SET UP END OF LINE BRANCH 


Input: LIHPU- 


■ ^^ STRING TO WRITE"=%Input* ! ASK USER FOR STRING TO OUTPUT 


i 


qpi ci^int (Sei ert__code, Input*) 




■ DO OTHER WORK WHILE INTERRUPT 


I==I-i-l 


! OUTPUT IS IN PROGRESS 


GOTO 190 




] -y- rjnr'-i^ 1 riTl- 


;P -"■ OUTPUT C0i1PLETE= = =NEKT '' ; i GET HERE WHEN ISR OUTPUT K 


GOTO Input 


1 COMPLETE. =. SO REPEAT 


I SOURCE 


MflM Output qpio int 


^SOURCE 


EKT Get v-alue. Error exit,Isr access 
Select codeiBSS i " 'i RFSERvFD TO HOLD SF^ FCT i 


I SOURCE 


String: ESS 81 i RESERVED FOR ISO CHAR STF 


iSUUNUt 


Hyte__po;nter:i:iSS 1 i hyih rUlHitK hOK ISK 


I SOURCE 


S.aw35: ESS 1 \ TEMP FOR ISR 


TC;ni |pf:P 


Or: EQU 13 ! EQUATES FOR CR.--LF 


I SOURCE 


[_(■ I FPU 1 A 


I SOURCE 


Ersble rrask:EQU 2806 i 98832 INTERRUPT ENAELE Mf 


I SOURCE 


! 


I SOURCE 


! ROUTINE TO OUTPUT A STRING FOLLOWED BY CR-'LE TO A GPIO-L: 


I SOURCE 


: INTERFACE USING INTERRUPT= 


I SOURCE 


! 


IsnURCE 


! ENTRY point: nutput___qpici...int 


TQrji iprp 


! PARAMETFRA:: 1 ) TnTFGFR rnHTHlNlNf: API FAT CHTlE < 1 Tfi U 


I-dU-JKL t 


1 2) STRING TO BE OUTPUT 






I SOURCE 


\ POSSIBLE ERRORS: 19 SELECT CODE OUT OF RANGE 


I SOURCE 


! 164 CARD OR PERIPHERAL DOWN 


I SOURCE 




I SOURCE 


SUE 


JSOURCE 


Kl^HJr: :5tR 


J^SHSS^ 


Outnut anio int:LDA =Select code ! GET THE SFi FCT CODF pRRi 


-.-..-.: :r-..-..— 


i DA Select code ! i OAT A WITH SFi FCT COTiF 
ADA =-1 I CHECK FOR VALID RANGE <i- 


TCfii jpr> 


SAM Sc error 
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ADD CK/Lh 






[Sl iUKi 



' !-=tL.i i f n!-=i.:=-; 



J0S 


ISOURl 


j10 


ISOURl 
ISOURC 
ISOURl 


j30 


340 


ISGURC 



K4, 1 






LUH i-'a 






rUET TCP 



iDE 

-Mfl 
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:1H:: 



Interrupt String Input 



i-lHELh BVTb oHOULL! 



'4H 1 ! 1 NC 



•Hl:E = 








(i: i::::> 


1 


a:: Pi 


I..l.,l 


u i 


t 


i::::i o: 


i..l..l 


iJ::: 



! 

uj ■-■■■ 

L.J i...'1 

H- ix 

lij 

I l".| 

ijj i--^ 

i:.i"i I 

ci: 

j;;:: 

il. 
o: 

ix: UJ 



i..i..l 






y 






II 


liJ 






i:...:i 
1— 






II 

LI..I 


l.,i... 


LiJ 


LJ 


LiJ 






L.i::. 


il-l 


5"' 


t— H 


ijj 




Cr' 


I'M 


-t 


Q~ 




ifi 


■ .' 


(Tt 


ill 




a:: 


i~:.\ 




::k 


!-.< 


LI;:: 


l..i::. 




\±. 


..'"" 


'..._' 






! ) 


II 


<1... 


IJ... 


I..-I 


y 




i:i::: 




I 'I 


^.?.■| 




a: 


0'!' 


U::. 
U..I 

LlJ 

l—l 
ID 




Ij... 

ijJ 
UJ 

IJ"! 


I— 
U., 


Ll.. 
i-M 

0... 
CO 


iX 
Xi 

I-- 

LiJ 


I..U 

Lt: 
1~ 



LJ.J 






i'7j 


l—l 


Lt:. 


\;~ 




u. 


L.t. 


, 


--', 




fr' 


r 1"! 


H- 


CZ' 


IX 
LlJ 
|-K- 


LlJ 


H- 


1 


i.iJ 


a: 


i-.-H 


'Z! 


UJ 


1 - 




i....i 


1-4 


i.J.1 


i'-Q 


i..iJ 


LL. 


CO 


(.... 




1.1, 


LiJ 


I.K 




I.I..I 


I..1... 


1-- 


iX 


~7" 


M 


. ^ 


■■■.... 


1 


a 




i::m 


(M 




~"| 


iX 


1 1 


LL. 


)..„. 


LJ 


1 


Ck. 


1— 


ix. 


U.. 


X. 


h- 


i..lJ 





I r I-— 4 i'Si ijj I'- 



!.._( h-H 


CI.: 


!.£. 


i__„! 


IX 1- 




C.j CO 


LlJ 


i::i::: 


..!.. 


iX '-1 


I_... 


u. 


!.l..l 


1- \±. 


fLj 


i-i a: 


iX 


iX 1- 


"^ 




LlJ 



iT 


CCi 


II 


i-< 


o 


1- 




h- 


.... 


l,l..l 


a:;; 


1- 


x: 


ijj 
II 


b 



B 
<a 
>-i 

CO 

o 

Q) 

S 

(0 

c/) 
O 



.::;;:. 


I-- 


I...H 


i::i... 


LJi 


ll:: 
ll:: 


IX. 
1— 


ij..i 


LL, 


ID 



a a:. 



LiJ 

UJ ix 
:z: Li... 




,i:j... 




Li::: 
i..ij 

1 

I..LI 




i..i..i 

LlI 
....J 




l-'l I.J::. 

H- U..I 




Li:: 




ix 

iX 




CCi 




iX '-^ 




LlI 




Ci... 




ll. 




I..I.J LlJ 


I.JJ 


UJ 


U.! 


fjj 


UJ 


UJ 


LU L 


iX Ll 


Qc 


cl: 


ll: 


a: 


cl: 


&? 


Li::: IJ 


CO CO 


I'j'i 


in 


u'-i 


&> 


w 


CCi 


c::i c 

CO 


i.-..| |_.H 


l—l 


i-.i 


l—l 


1~H 


l—l 


1....H 


1—1 1- 



il s :i 


1 1 


c. •+• 




l: iTJ ^~■ 


i,':!:' 


ill U .1 


|i::i-. 


\-~\ I.J.. M.I 

™..i II L.:i 


ij.i 

CO 


I IJ 1 

II CO 11 


U 'I'-i 

CO II 


"» m::i 'E: 

I-:- Pi CO 


a: 
._J 


>T. -f: a::: 

i-i iX Pi 

i:r o-,i ix 


:iii: ix 
a: p-i 

CO -J 



1.1,1 

!• 

i..i.j 


• » Q. 




1 1 IT 


i:r: 


Ml 


u:. 


1 !- 


iX 




I..L. 


Il » -i-" 




i-rt :;::: 


— ' — • 


iX LI..I 



+ X Ml 



J. * 



■•'i' iTl 

ij':i ix 


iTl 1-1 ■■-■■ iii ij'i 

:...:i II II CO i-H 


UJ 


Ti 


+•:■ CO 
CO II ■' 


-1 II 


firi 


IX cr. 
Pi h- 
....J CO 


:..j ix (M iM x: 
10 i:...i l—l Pi I'd 
X J -J iX '•■■•:. 


i-., 


a: 
I....I 
...,j 


i:e a: .. 

CO -J c 


..1 ii: 
:> i:r 


iX 

i...„ 



--I- r-... 



cj a: o:: 

U.. f"! I"- 



,■* 




i. f! L. 


,-■■■ m 4- 


LlJ u":i 

II iX 


.-I 


'll UJ 


cij a.. :: 
II II a. 


■X ix: 

Pi !•■- 
,..,J CO 


I-- 

LiJ 
Ci::: 


a: e: 

a CO 


p:! LtL i:r i-Q :e 
:::.i h ■ t::4 i:^ cc 
ci':i CO 1 ,.-J '••■■ 





W 


i; 


iTl 


.Ti 


ij.i 



x: 


'T. iX 


i-i 
..J 


I---- 1...-I 



UJ UJ I..I.J i..l.J U.I UJ UJ U.J IJ.J I.JJ IJJ LlI UJ LU LU Ll.J UJ Ll.J UJ UJ l,i.J I.J.J UJ I..lJ Li.J I.,1.J Ij.J I,,I.J Li.J UJ L1..I UJ Li.J Ll,.l I,lI LiJ UJ l,.l..l U.J I.J.J iLl lJ.J U.l Li.J UJ |j.J LU j.jj ij.j LU Li..i 

St tx li:: ix i:J::: cl: ci;:: i::t:: ll: Q;:: ci-:: u-:: ix u:: ck. ll: ix ct-: ix 



ll:: ll:: Lt:: lk: di ix i'lC ll:: ix: u; i::t: lI:: ul 

....J Z'j ::::j zj ~j ._.j ™j i:ii i i :~j ...j jj 

CD CD c"i CD CD i~i CD c~i czi c~i i:::j o c 

I'o iT'i cci 0"! CO cci 1.0 CO i:.o cci cij co o* 



1—1 1- 



Lt:. u:. Lt:. Lt. us:. la Ct: 



III IJ .1 L' .* 1 1 :i fj .1 '" I 



j 1 1 

1 il:: 


iX iX 


(2. •at 


ix cl: ll 


-' ":- 


TT. ■■::z 


■■.rz — .' 


--.=' ■;-„ ~'.; 


"1 I'O 


O"! CO 


ij"i CCi 


iTi ci'i i:'i" 


~< 1—1 


1-...1 t-H 


1-4 1-.-1 


l—l H-1 I— 



III LLI LLI LL' i,J,i LLI 



■■;:l- Li'. I 
■tf ■* 



UJ r-... 

■■■.:l" T|" 



';t- ■■r|- i.i' 



.1 CCt i^j 'S' Gi i.j.1 ijj ijj iS 

:i ■■■~i C'.j 0:1 -'.f uD I..L1 r-„ CO 
.1 ir.i UD i.i"> 1.1":! ij"! ij":i l.i"! i.r: 



■'71 


1'^ 


1 P^i 


Cl^i I'^i CD 


iXi 


3:1 


Cii 


CD ir; I'^i r 


Z' 'Xi i''~i 


i'';ri i'^ 


1 c-D 1'" 


I-', 


CiD -•■ 


f c-.j 


1.0 -^ Ll.i 


'■.D 


■■... 


1 1'l 


ij-, ir;i ,,,,-1 r 


.J C':> •d- 


Ij.i Li 


1 r-. c 


I"! 


'■£' 'J 


1 Ml 


'■j:i '-.0 'D 


U.1 


..u 


Ku 


cu f.- r'- r 


.. r-,.. r-. 


!■•... I-- 


. r-- r 



C;i.i i''Ti C.J CD 



I V i-.i i.ii Cii.' 1 

■'■:i- in '■£! r-- 

iTi rr'i rn rri ri 



U.i iTi O'l 



C'i OD Tf- 



CCi O'-. Cf'' O'i iT, IT, iT, 



00 
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IHTH EVTF 



H-10 I/O Sample Programs 



DMA String Output 



■^:i- MCE = 



TJ-.J i ppp=-;f:p r:Hr 









l^S:^:lJj^-^ 


y 


riIM"'lnS?$Ei60] 


00 




1 w 


I RSSEfiELE "" 


20 


INPUT "SELECT C 


~7-\P\ 


OH IHT #Select._ 


4ti 
50 


Input: L INPUT " 


60 


ICRLL Out-put qp 


70 


i 


80 


T\ T sp T 


90 


1=1 ■■f-l 


00 


GOTO ISO 






[HBi F TO 



JR 


i 1 t 


u 


'■' 1, be 


ect c 


ode 




"0 


Dnw 


dc 


'■'f\^- 


! SET 


UP EN 


D OF L 


'("■: 


URF 


~p ■' 


■■■- r,-.. 


jut^ ! 


flSK 


Jy£p p 








de, I 


iput*:: 
! OUTF 


THER 


IN PF 


- 


JOMPl 


_F~ 


-.- , 


ir- ',■■■, 1 


. . c 


ET HEF 






HHM Uutput 









i hTJUR I PS hOK i:K.--'L.r- 






TThiP rr 



KUUl ir-ih 



"1B 






jr1Fl---INl •••■"flH EN Hi 






140 






ER O 


)N 1 R I N 


b TO 


BE CiU 


SELEi 


:J COD 


ChRD 


OR P£ 
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ird oi 



CRkD iS Uf 



■flKHnh I ER 



HDfl String 



chhrhc 



HUH 
STfl 






rillf-i = i 
STH Iin>3.= 



'~i r, J^' J - ji"-> 









LCF 









1 lyy 






.Dh Pa 



! BiiHELh. DnH 

! CALL THE CORRECT TERMIHH1 



H-12 I/O Sample Programs 



^ y, i Pi 



1 :j4y 



1410 






50Uk( 



[OR Sbl 1 
jTE EoI I 



!_1!H 


X j--r pi:- 


LDfl 


= 103B 


STH 


B,I 


HDB 


— C- 


LDfl 


Eol_rfia 


DIR 




I OR 


E,I 


STR 


E|.I 


EIR 




LDfl 


Save35 


STfl 


35E 


RET 


1 



! AND NOW TRIGGlR AH tHD Oh 

! CORRECT ilflSK WORD MUST BE 
! CflLCULHTEB BY H COMPUTED 

! SaVE THIS MASK 

! AND USE MAGIC CODE TO 



! RETURN FROM INTERRUPT 
I BIT MASK FOR INSTRUCTION 



JURl 






DMA String Input 



iff 
40 

=10 



! THIS PROGRAM INPUTS H STRING USING DMA FROM A GPIO INTERFFli::E = 
! INTERFACE CARDS flppLICAELE ARE: 
i 98032 16 BIT PARALLEL 



3 Pi 



1 ciu 
139 
1 if.y 

160 
170 

190 
200 
2iH 



iueletl all 

ICON 1008 

DIM Input*[i603 

iNTLbtR Uhar-zLCter count 

INTEGER A,C ~ 

I ASSEMBLE 

INPUT "SELECT CODE TO READ FROM?'\ 

ON INT #Se^i=i~t rndf^ GOTO Isr dnrif^- ■ RET Up END OF LINE BPANCi" 

INPUT "NUMBER OF CHARACTERS TO READ-"'^% Cl-aracter count 



! ALLON FuR Ifc-y uHAKflCTbR STRINb 
! BASIC VARIflELE TO HOLD THE SELECT CODE 
! VARIABLE TO HOLD INFUT CHARACTER CO 
! VARIABLES FOR "BACKGROUND PROCESS" 



= :-!==- 



iCALL Enter qpio <±\<a.' 



j:ode,Craracter__count> ! STAR I iHl RhflD 

{ DMA COUNT AND 



ICALL Test_dma(C,H> I WHILh WAI i ING, DIS 

DISP "DMA CnUNT=":C, "ADDRESS=" ; A, I ! ADDRESS 

GOTO 190 



y Isr_;done: ICALL Read_resui t<Input$> 

DISP "INPUT COMPLETE. ..= STRIHG="; Input* 



"1 hnter qpio m& 



ISuURC 



t ^.alue.Pu 









g" J:5SS 81 



J:-=.b i 



! RlSERVlD Tu hold SLLLC I CODE 
\ RESERVED FOR 160 CHAR STRING 
! RESERVED FOR EXPANDED STRING 
i jrhip FOR ISR 
! TEMP FOR ISR 
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36m 



400 

410 



44£ 



4HM 



510 



u4i 



600. 

610 
6-20 

650 

67-0 

690^ 
700 
710 

720' 



810 



.ijUiJKL-t. c 

.SOURuE i 



THTi-Ri-fHri- iJsThli-, TiMH. 



isnuRc 



( point: 

! PRRpMFTFR: 



?r qr 












isoukce 

I SOURCE 

I SOURCE 
I soy RCE . 

I SOURCE 



loUURCt 



HTKY PUxHi 



psgoroPT? 



[64 CHHD or per It 






!. hHTRY POINT..: K&ad 

■I 

: r tiKfilit: I tifx » iJ -d i 



T:-, 


OURi 


";P 


T.C; 


jURi 


l;E 


IS 


OURi 


2£ 


iy 


OURi 


.-fc 


I'd 


OURi 


_.p 


IS 


OURi 


I£ 


T C' 


OURt 


::£ 


IS 


lURi 


Viz 


IS 


OURi 


-•r^. 


IS 


OURi 


Jt 


IS 


OURi 


jE 


ii 


OURi 


-■r7 


IS 


OURi 


Jt 


Tc 


OURi 


-•fcl 


IS 


OURi 


I:E 


IS 


jURl 


--t 


IS 


OURi 


J-E 



m__cour 


--•1* " 


INT 

IHT 




er_qp. 


o 


dim-: 
■ LDB 

JSn 


LBfl. ^Select 
=Rarni__sc 
Get- 'ja. 1 ue 






ldh 


Select: code 






HD.H 


.=.-1 






C;Qhi 


Sc error 






RDH 


=-T5+l 


error 




Sfill 

L-Dfl 


= 19 






J3M 


Erroi^exi t 


:~ !■:' * 




LDfl 


~OX-t' 1 i""":Q 






LDB 


=Par?ii__count 






TP.i'i 


Get Malue 






LBfl 


String 






SHf't 


Sc__error 






Hllfl 


=-^1 




-d: 


SAP 
LDn 


Sc error 
Select_code 






STH 


Pa 






LDH 


Sf'^' 






JSM 


Pi.-. |.-r. ,-.}.-. p-vit 



840 


I SOURCE 


850 


ISOURCE 


860 


I SOURCE 


870 


ISOURCE 


880 


ISOURCE 


890 


ISOURCE 


900 


ISOURCE 


910 


ISOURCE 



iHuURi: 



STH Dnac 
LDH =Strinq+l 
STH Driama 
fill I 



TO CuNTHiN IHE IHPUl DHm 






.^HhUK PiJK VHLID Ri 



bh i BYTE CijUNT Pi 






-' HN ISR 



"TRl IZF Di^lH R? 



?HHE 
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kivy 



J'-'-£. 



LDFi =hr!-=iL 






ENHELh THt UHRil iu IH1 



iTIOH 






:K r-ijR DMfl 



jji^r;!-::' 



- G- F C - M 



INi 




Ti- 1~ 




ir-i j 




LDH 


Dnac 


sTh 


Temp 


LDH 


=Temp 


LDE 


=C parrn 


jsn 


Hut__:..r3Llu 


LDR 


Druaraa 


STfl 


Temp 


LDR 


__-r 


LDE 


=R parm 


jsn 


Put '..^alu 



■-■yy 

4fiR 






1 180 


IE..:. J- IE. 


T^-r 


iF- 


; 


BSb 


1 




1 1 90 


::.uL-.:£ 


1 












1200 


:e.q._p:e 








SUB 








I :•._.._.."" '_ z. 


r-:d.i" 




3t.r: 


STR 






1220 


lE.j.J^'ZE 


R? 


■a 


j_re3 


u 1 t : LDH 


=Str 


-■inq+ 


1 230 


IE ju-;e 








STfl 


D 




1240 


:e':.'C'..e 








SflL 


1 




1 250 


rE-.i'_-iE 








HDR 


=-1 




1260 


lEIr.J-IE 








STR 


c 




1270 


lEI.Jp^.IE 














1 '^Hfi 


:e.:.l"^':e 








LDR 


Strir 


''9 


12R0 


TE-iJ-'PlE 








TCR 






1 300 


1 E '-• J ~' I E 








SIR 


*+4 




'310 


- : -, ,c; r 








uyn 


P T 





IS. 






■Lt 



F.IE 



E, I 



KiH *- 



.DR :j4j:: 



RDR =1 






HDH =-8 



- r:i3 1 ■=.! 

!-+3 






! GFT r:HHF 









)UN1 



TO ERSIi 






JHEi- 



I UE i Tu HEKt. WHhH DMR DONE 
JOHPUTE RCTURL HUriEER OF 












::lc liril-1 



-:ri 
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1 Cf oU 


I5iI..-.^.I- 


HDB 


=3 


1670 


ISOUf^'CE 


LBH 


Eol 


16S0 


IE...._'^ME 


DIR 




1690 


I !■ jJF''_C 


I OR 


r= T 


1700 


IE..:i--!p._£ 


STfl 


H- T 


1710 


lEC.lJi^ IE 


EIR 




1720 


is.:LiPr£ 


LDH 


o-a--.-- 


1730 


lECuRIE 


STH 


35E 


1740 


IzOJ-ZE 


Kb 1 


1 


1750 


I50bF._E Sbll: 


SBL 


1 


1 !'' bb 


ISOUPCE ! 






1770 


lEGLiPCE 


END 


Eni. 



! RETURN FROM INTERRUPT 
! BIT MHSK FOR INSTRUCTION 



qp 



HP-IB Output/ Input Drivers 



mn nrijs L-riKJJ iJK, 



4Cl 



hi kPV #is rinin i .=.=.t. 



jTQ ppTfJT " H 



IHM 
1 10 
120 



PRINT 

PRINT 

PRINT "Ti40 FiSSEHELY LRNGUFlGE DRIVERS FiRE PROVIDED. = .ONE FO 

PRINT ^'FOR INPUT. BOTH HRVE PROVISIONS FOR INCLUDING H BU 

F'RINT "FOR ADDRESSING THE BUS. " 

PRINT ^^SYNTRy;^^ 



jUTPUT AND ONE 
;0f1MFiND STRINC 



230 

240 



PRINT ^'ICflLL Hpib_output':: <ISC>, <CMD*>, L <DHTfl*> ] >"■ 
PRINT "ICflLL Hpib_enter >■. <ISC>, <CMD$>, E <VflR*> 3 >'' 
PRINT 

PRINT " <CMD$> ::= STRING TO OUTPUT WITH HTN TRUE" 
PRINT ■" <DHTfi*> ::= STRING TO OUTPUT wITH HTN FALSE" 
PRINT " <VhR$> ::= STRING VARIABLE TO HOLD DATA READ FRi; 

PAUSE 






30Ci 



! 164 CARD NAS NOT AN HP IE CARD 

! 500 <CnDf> WAS NON-NULL BUT THE CARD WAS NOT ACT! 

i 501 <DATH$> WAS NON-NULL BUT ' THE CARD WAS NOT AC" 

' ■_'''J.'::i. \ Viii^. ■?",-■ WrlO Oi C-_-li iCJ-' Li'*—'i i fiLl '^-^If^. i_= l-MriO ri!_i I ri=_- 






J20 INTEGcR Select._rode 

330 DIM Cn(d$C160],n3.ta$Clb0],Var*[1603 
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350 INPUT "HPIB SELECT CODE?" , Sel €-ct_c ode 

360 PRINT ^'KEY - HUTPUT ' KEY 1 - ENTER 

370 DISP "IDLE" 

380 GOTO 370 

390 Output: GOSUE Linput_Cfiid 

400 LIHPUT "DFiTfi TO SEND?", Data* 

410 ICflLL Hpi b_output <Sel €-ct_code, Cind*, Dataf > 

420 PRINT " DRTH SENT =";Dataf 

430. RETURN 

440 Enter: GOSUB Linput_crnd 

450 ICfiLL Hpib__enter':Select_code,Cmd*,Var*> 

460 PRINT ''• DfiTfi RERD =";Var-* 

470 RETURN 

480 ! 

490 Linput_cmd: L INPUT "COMMAND BYTES v" ,Cr.!d$ 

500 RETURN 

510 i ast: SUEEXIT 

520 ISOURCE NRM Hpib 

530 ISOURCE EKT Get_yalue, Put 

540 ISOURCE Cmd: BSS 81 

550 ISOURCE Data: EQU Cmd 

560 ISOURCE Sel€Ct_code:BSS 1 

570 ISOURCE Parfii_ptr: BSS 1 

580 ISOURCE Lf: EQU 10 

590 ISOURCE Cr: EQU 13 

600 ISOURCE Statusl: ESS 1 

610 ISOURCE Status2: ESS 1 

620 ISOURCE StatusS; ESS 1 

630 ISOURCE Status4: ESS 1 

640 ISOURCE ! 

650 ISOURCE Out_parri! : SUB 

€€.'& ISOURCE INT 

670 I SOURCE STR 

680 ISOURCE F^data: STR 

690 ISOURCE Hpib_output :LDE =Out_parrn 

700 ISOURCE JSM Hpib_setup 

710 ISOURCE LDR Out_parTri 

720 ISOURCE CPfl =2 

730 ISOURCE Nci_uutput: RET 1 

740 ISOURCE LDR =ri.ata 

750 ISOURCE LDB =P_dat.a 

760 ISOURCE JSM Get__value 

770 ISOURCE LDR Mta 

730 ISOURCE SZfl Nc^output 

790 ISOURCE JSM Hpib_status 

800 ISOURCE LDR Status4 

810 ISOURCE AND =40E 

820 ISOURCE RZfl *+3 

830 ISOURCE LDR =501 

840 ISOURCE JSM Error_ex1t 

850 ISOURCE LDR =riata+l 

860 ISOURCE SAL 1 

870 ISOURCE STR C 

880 ISOURCE CBL 

890 ISOURCE Eata__1oop: SFC * 

900 ISOURCE WBCR4,I 

910 ISOURCE DSZ Hata 

920 ISOURCE JMP rtata_]oop 

930 ISOURCE RET 1 

940 ISOURCE ! 

950 ISOURCE Ent parrf.: SUE 



6 - EXIT" 



l1 ue, trror_exi t 

! STRING TO HOLD CMD BYTES 

! STRING TO HOLD DRTR BYTES 

! INTERFACE SELECT CODE 

! POINTER TO PARM PSEUDO OP^ 

! EQUATES 

! 4 WORDS TO CONTAIN STATUS 

! BYTES FROM 98034 



! CALL SETUP ROUTINE 

! IS THERE fl DATA PARAMETER- 

! NO, RETURN TO BASIC 
! YES, FETCH IT 



CHECK BYTE COUNT 
IF ZERO, DO NOTHING 
MAKE SURE wE ARE ADDRESSED 
TO TALK 



! ELSE GIVE ERRO 



>01 



! ELSE COMPUTE BYTE POINTER 
! SO WE CAN WITHDRAW BYTES 
! FROM THE STRING 

! WAIT FOR CARD 

! OUTPUT A BYTE 

I SEE IF DONE WITH STRING 

i NO 

• DONE, SO GO BACK TO BASIC 
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1000 
1010 

1 020 
1030 

1040 
1050 

1060 

1080 
1090 
1100 
1110 

ll20 
1130 
1 i4y 
1150 

1170 
1180 
1190 

1200 

1210 

1230 
1240 

1 2t>£i 

1280 
1290 

1300 

1310 
1320 
1330. 
1340 
1358 
1360 
1370 



1 =1 ^ c* 

1420 
1430 
1440 



14':?y 

1 500 
1 rt?fi 



1550 

1570 



bOUKCE 
SOURCE 
>OURCE Ent 
SOURCE Hpi' 
JOURCE 

SOURCE 
ISOURCE 






E-OURiJh 
OURCE 



iOURCE 

OURCE 
SOURCE 

SOURCE 
SOURCE 

1 ipr-c 

S'OURCE 

SOURC E E m- er-_^ 

SOURCE 

SOURCE 

SOURCE 

JOURCE 
SOUR'Ch 
SOURCE 

SOURCE 
SOURCE 
SOURCE 

SOURCE 
SOURCE 
SOURCE ! 
SOURCE ! HP IB 
SOURCE ! B 

SOURCE I 1) 
" lURCE ! 2 > 
SOURCE ! 3> 
SOURCE i 
SOURCE Hpib Si 
OURCE 
OURCE 
cSOURCE 
:iURCE 

OURCE 

OURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 
SOURCE 

ISOURCE ~ 
ISOURCE 

ISOURCE 

isnnpcF 



JSM Hpib_seti.jf:' 

LDH =Erit._t:artfi 

CPfi =2 

RET 1 

JSM Hpib_status 

LDfl St-atus4 

flHD =20B 

RZfi *+3 

LDH =502 

JSM Error exit 

LDfl =0 

STfl Data . 

LDH =B3.ta 

SHL 1 

flDH =1 . 

STfl C 

SFC ■*• 

LDfl R4 

SFC * 

LDfl R6 

CPfl =Cr 

JflP Enter_1oop 

CPfi =Lf 

PBC fl, I~" 

ISZ Data 

JMP Ent er_ loop 

LDfl =D3:ta 

. LDE =Ent._i..var 

JSM Put_Malue 

RET 1 



SETUP ROUTINE 

POINTS TO SUB PSEUDO OP <COHTflINS PflRM COUNT) 

VERIFY PflRHMETS? COUNT >=2 

FETCH SELECT CODE AND VERIFY CARD IS ft 9S034H 

FETCH COMMAND STRING PARAMETER AND OUTPUT IT 



! CALL SETUP ROUTINE 

I IS THERE H DATA PARAMETER? 

\ NO, THEN I-^D DONE 

! MAKE SURE I --M fl LISTENER 

! ELSE GIVE ERROR 502 

! CLEAR DATA STRING COUNTER 

i SET UP BYTE POINTER FOR DATA 



i WAIT FOR CARD 

! START ACCEPTOR. HANDSHAKE 

! WAIT FOR DATA 

! READ DATA FROM CARD 

! IS IT fl RETURN? . . 

! IF SO, IGNORE IT 

! IS it' TERMINATOR? 

! ELSE PUT BYTE INTO STRINC 
! BUMP STRING LENGTH 
! REPEAT FOR NEXT BYTE 
! RETURN DATA TO PARAMETER 



:-tup: LDA E,I 

ADA =-2 

SAP *+3 

LDfl =8 

JSM Error_exit 

HDB =1 

STB Parm_ptr 

JSM Get_Ma1ue 

LDA Select_code 

ADA =-1 

SflM Sc__errDr 
flDA =-15+1 

SAM *+3 

yr'- ^ LDH = i y 

LDA Select_code 

C-TO C=-. 

-_* 1 i i t -rx 

JSM Hpib status 



! CHECK FARM COUHT 

! IF <2, GIVE ERROR 8 

! POINT TO SELECT. CODE PARM 

! rhTUri iT 

I CHECK RANGE FOR 1 TO 14 



[ r ijU ! Ur RHf ■! 



ijivin nr-.r-.uri. 



! SET UP PA AND DO STATUS SEQ 
! ON CARD TO VERIFY IT IS A 
! 98034fl INTERFACE 
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1590 

1600 

1610 
1628 
1630 
1640 
1650 
1660 

i fc f y 

1630 

1690 

1700 

1710 
1720 
1730 
1740 

1760 
1770 
1780 
1790 

1800 

1310 
1820 
1830 
1840 
1850 
I860 

1830 
1890 

1900 

1910 

1 920 

1940 
1950 
I960 
1970 
1 980 
1 99£i 
2000 

20 1 

2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 

2100 

2110 

2130 
2140 



ii. 
sni. 

Ml. 

OU 
01 

'01 
;ri!. 
;ni 



oOi 



;ni. 



KL-t 

RCE 
RCE 
RCE 
RCE 
RCE 

Ri'E 



■■arm p 



RCE 
RCE 

RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 



RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 

pl !!*- 

RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
RCE 
R!CE 

RCE 
RCE 
RCE 
RCE 

RCE 

RCE 



Cnid 



Ho cmd: 



LDE 

HDE =3 

LDH =Cnid 

JSH Get._'...=alus 

LDH Cmd 

SZfi Nc^cmd 

LDR Stat.us4 

hHD =100B 

RZh *+3 

LBR =500 

JSn Error_exi 

LDfl =Cmd+l 

SflL 1 

STfl C 

CEL 

SFC * 

WEC R6, I 

DS7 Cmd 

JMP Cmd_loop 

RET 1 



HOui FETuH COMMAND STRINij 



SEE IF THERE IS FiNYTHING 

OUTPUT, IF HOT, SKIP 

riHKE SURE I m ACTIVE 

CONTROLLER 

SKIP IF YES 

ELSE GIVE ERROR 500 

! NOW OUTPUT THE COMMANDS 



StND OUi CMD BY it 
SEE IF DONE 
NOT YET 
DONE ! 



I STATUS SEQUENCE FOR 98034 CARD, NOTE THAT THIS SEQUENCE 

! COULD FORCE THE CARD TO VIOLATE THE IFC TIME SPECS IF 

! THE FOLLOWING CONDITIONS EXIST: 

! ly CARD IS NOT SYSTEM CONTROLLER 

! 2> A HARDWARE INTERRUPT OCCURS AFTER THE LDA R5 BUT 

! BEFORE THE DIR 

! 3> THE CONTROLLER PULLS IFC AFTER THE LDA R5 BUT EEFC 

I THE DIR 

! THE ONLY ALTERNATIVE TO THIS IS TO DIR BEFORE THE LDA R^ 

\ THIS HOWEVER COULD COMPROMISE ANY 3YNCHR0NUS INTERRUPT 

! TRANSFER IN PROGRESS ( FOR EXAMPLE THE TAPE CARTRIDGE >. 



Hnib status 



RC 
sni IPf: 



LDA R5 
AND =60E 
CPA =60B 
JMP *+3 
LDA =164 
JSM Error_e> 
SFC * 
DIR 

LDfl R6 

STA Stat us 1 

SFC * 

LDH R6 

STfl Statu£2 

LDfl R6 

STfl StatusS 

SFC * 

LDA R6 

EIR 

STA Status4 

RET 1 

END Hpib 



GET THE CARD INTO 
IT-'S STATUS SEQUENCE. 
MAKE SURE IT IS A 98834 



! IF NOl 



'i I VE lRROR 



MADE IT, 
INTERRUPTS 
THF STAT 



■^t L-RITIUHL 
J DISABLE MY 
FOR THE RES' 
"'■"""'ENCE^ 
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Real Time Clock Example 



-K . ^^F 



,-,-,r;, c I_!" 






n..-!-£-.C'jPT 



■.'C-^~i- --. TT- 









#H r:fli 



it I UH lyK HMU HfHh; 






>i H ra 



T nSSEMEL 


.ER 


TO 


IBMrUTE 




E EOL Mas 


■K F 




TRIGGEF 


i'ti 


_ EKflHCHES 








4ER EQUfl^ 


'bS 








ER TO HOLB T 


I ME 


OF DflV 




J WORDS 1 


"0 H 


Old 


CURREN 


1 


INTER IS 


AND 


PR 


INTER K 


ID 


..-rr C-ljpr: - 


'HE 


--! - 


-.:,. :-.Cipr 








6 5-i--:. 1* 


lb .: 


-:=-i £=-_: = 35 


fe'-- — • 




, __ „^.p^ ^,_^ _._.,., 


card 




_ ^^-r.^^ V%^ '^c^!^$:y^- 


Clock 




, --ir-. -- ^,2=-'-^ 


U4=04.-i 


J4r 


' 5 IE --.iMFir :o_.N~-: ■ 
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630 
640 

650 

670 






I SOURCE 






o I H K ;■■' 
RIB Out- N 
LDR =20yB 

RET 1 



TQniiPpp 



:13H ~Se 


! f C % 


STH Pa 




SSC ferd 


dowr 


LDFl =-R ' 




SFC * 




STH R4 




STfl R7 




LDh =Lf 





STH R4 

LDfl =S' 
SHL 1 

hdh =1 



i JKlbGEK hhndshhke 



' f c i i_ri ! int. 






ilE 



SET UP C TO PUT TIME 



40 



S90 

900 

910 
920 
930 
940 
950 
960 
970 
980 
990 

1000 
1010 

1050 
1060 
1070 

lyyy 

1100 

1 1 30 
1140 
1150 



IS 


jURi 


jE 




JURI 


-'C 


IS 


JURi 


-;P 


J.-I= 


DURi 


JE 


IS 


lURi 


-■C 


T -• 

1 o 


JURi 


I-E 


IS 


jURi 


JE 


IS 


JURi 


vtz 




jURi 


JE 


IS 


JURi 


-•L 


IS 


jURi 


JE 


IS 


jURi 


'■E 


IS 


DURi 


jE 


IS 


jURi 


JE 


IS 


DURi 


";P 


IS 


jURi 


JE 


IS 


liURi 


JE 


T ;-- 


jURi 


JE 


IS 


liURi 


Jt 


IS 


DURi 


JE 


IS 


jURi 


-•iZ. 



-L biKiTHi. 



0UN1 



:Tfl String 
;FC * 
.DH R4 
iTfl R7 



ISOURCE 
I SOURCE 

ISOURiDE tlefiiov: 
ISOURCE 



jrlH i^ot t. i f 
■'EiJ R. I 

-Dfi =18 "" 



STfl iDid pi 
STE OICp-^ 

■JMP Meniov 

HOP 
LDfl 01d__pi 
LBB u1d__pw 
.JSM Printer 
RET 1 



WfilT FOR CHRD 

START INPUT OPERhTIOH 

TRIijGER HflHDSHflKE 

NflIT FijR CRRD 

GET THE NEXT EVTE 

IGNijRE CR-'S 

ELSE PUT CHhRhCTER INTO 

STRING HND BUMP COUNT 

REPEAT 

SET UP ^^ PR INTER IS^^ FOR 

MESSAGE AREA 

SAVE OLD 



JJO THE 






ii-sNORh STOP Kb"; 



! RETURN TO BASIC 



1 C* T j~l-.ji-ji -'"'QpTj TLjCjT ;.iC i~o'=" "^1 

! INTERRUPT BY DISABLING HNj 
! THEN RE-ENABLING THE CARD 
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= 10:: 
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Appendix 1 

Demonstration Cartridge 



Along with the Assembly Language Development and Execution ROMs, a tape cartridge has 
been provided to demonstrate the capabilities of the assembly language system. This Dem- 
onstration Cartridge (HP part number 11141-10155) is specifically intended to — 

• Graphically display the kind of speed increases which can be obtained by using assembly 
language subprograms for certain types of applications. 

• Provide a number of programs which can serve as examples of how to write assembly 
language subprograms. ^ 

• Provide a set of definitions for some of the special function keys so that those keys can be 
used as typing aids. 

Using the Tape 

To run any of the demonstration programs, execute the statement — 



A set of instructions is displayed which can then be followed interactively. 

Typing Aids 

The starting and final cursor positions of the typing aids were chosen with assembly listings in 
mind. The intent in selecting these positions was to make it easy to enter source as it would 
appear when listed within an assembly listing. 

The following table gives, for each key, the typing aid, the position where the typing aid begins, 
and the position where the cursor will finally reside. Because some typing aids end with a blank, 
the triangle (A) has been chosen to indicate the end of the typing aid. All blanks £.ter the start of 
the typing aid, and before the triangle, will appear when the key is pressed. 

1 The commented source for the chess program is contained in file CHESS. 
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Key 



Typing Aid 



Typing Aid 
Starting Position 



Final Cursor 
Position 



5 
6 

7 
8 

9 

10 

11 

12 
13 

14 
15 
16 
17 
18 
19 

20 
21 
22 
23 
24 

25 



A 
A 

I A 



[CLE Am .— :- 
I LINE I U ll 



! A 



^^A 



3HVE --"A 



CLEAR] r-T:-:— 1— ■ 
I LINE J ■_: i UKL 



/CLEAR! .-.,-.-■- '■ " k 
\ LINE ) L- M I " " i\ 




:T^^A 



T A 

5 A 



PRINTflLL 


T ;- 

J.-:: 


I BREAK A 




IFflUSE A 




IHSSEMELE 


A 



(used by other keys) 
(used by other keys) 



u.^ 



(use only after using keys 9 or 11] 



11 

11 

11 

home 

home 

home 
home 

11 
home 

home 

home 

home 



51 
home 

current - 1 



31 
19 
21 



7 (over second quote mark 
in insert character mode) 

6 

11 (over second quote mark 
in insert character mode 

53 

6 (over second quote mark 
in insert character mode) 

7 (over second quote mark 
in insert character mode) 

7 (over second quote mark 
in insert character mode) 

8 (over second quote mark 
in insert character mode) 



home 


6 


home 


6 (over second quote mark 




in insert character mode) 


home 


6 


home 


9 


home 


12 


home 


13 


home 


8 


home 


8 


home 


11 



53 

18 (over second quote mark 
in insert character mode) 

current + 4 (over second 
quote mark in insert 
character mode) 
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Key 



Typing Aid 



Starting Position 



Position 



26 
27 

28 
29 
30 

31 



(use before keys 10 or 11) 



(use only after using Keys 9 or 11) 



u. ^ 



home 
current — 1 

current 

current 

home 

home 



current + 4 (over second 
quote mark in insert 
character mode) 

current + 2 

current + 2 

8 (over second quote mark 
in insert character mode) 

9 (over second quote mark 
in insert character mode) 
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Appendix cJ 

Error Messages 

Mainframe Errors 

Missing ROM or configuration error. Also, check to see if all option ROMs are 
installed properly. 

Memory overflow; subprogram larger than block of memory. Also check to see 

IT ITrf'^llV ri ¥•*• ra T T (T* O*"^^ 4"^%/-k l^V^^^^ 4- y-k +54' 1*^ ^"^^ ^^•'v^ ^^*.T » 

Ix y\-/ui aiiayo aiS lwv^ idivjC' l\^ iil hi iiiciiK^iy. 

Line not found or not in current program segment. Check the spelling of line 
labels and line identifiers. 

Improper return. Branched into the middle of a subroutine. 

Abnormal program termination; no END or STOP statement. 

Improper FOR/ NEXT matching. 

Undefined function or subroutine. Check spellings. 

Improper parameter matching. Check the parameter lists in SUB and CALL, 
and DEF FN and FN statements to see if they match in number and type. 

Improper number of parameters. Check the number of arguments used in an 
FN or CALL reference. 

String value required. 

Numeric value required. 

Attempt to redeclare variable. Once a variable name has been declared in a 
DIM, COM, REAL, SHORT or INTEGER statement, it can't be redeclared in 
that program segment. 

Array dimensions not specified. You must dimension the array, either 
explicitly or implicitly. 

Multiple OPTION BASE statements or OPTION BASE statement preceded by 
variable declarative statements. 

Invalid bounds on array dimension or string length in DIM, COM, REAL, 
SHORT or INTEGER statement Strings can't be longer than 32 767 charac- 
ters. The range of array subscripts is -32 767 through 32 767. 
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Dimensions are improper or inconsistent; more than 32 767 elements in an 
array. Check for wrong number of subscripts in an array reference. Check any 
matrix multiplication for proper sizes. 

Subscript out of range. 

Substring out of range or string too long. Check substring specifiers against 
length of string. 

Improper value. Check numbers being entered, especially their exponents. 

Integer precision overflow. The range is -32 768 through 32 767. 

Short precision overflow. Short-precision numbers have six significant digits 
and an exponent in the range -63 through 63. 

Real precision overflow. Full-precision numbers have twelve significant digits 
and an exponent in the range —99 through 99. 

Intermediate result overflow. 

TAN (n * 7r/2), when n is odd 

Magnitude of argument of ASN or ACS is greater than 1. 

Zero to negative power. 

Negative base to non-integer power. 

LOG or LGT of negative number. 

LOG or LGT of zero. 

SQR of negative number. 

Division by zero; or X MOD Y with Y = 0. 

String does not represent valid number or string response when numeric data 
required. Check any use of VAL function and its argument. Check for correct 
spelling of variable name. 

Improper argument for NUM, CHR$, or RPT$ function. 

Referenced line is not IMAGE statement. Check the line identifier in the 
PRINT USING statement. 

Improper format string. 

Out of DATA. Make sure READ and DATA statements correspond. Use RE- 
STORE if appropriate. 
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EDIT strino longer than 160 characters. Try using a substring. 

I/O function not allowed. TYP and other I/O functions aren't allowed in any 
I/O statement like DISP or PRINT. Place the value into a variable. 

Function subprogram not allowed. An FN reference isn't allowed in any I/O 
statement, or in redim subscripts. Place the value into a variable. 

Improper replace, delete or REN command. SUB and DEF FN can only be 
replaced by another SUB or DEF FN. They can only be deleted if the rest of 
the corresponding subprogram is deleted. A renumbering may cause out-of- 
range line numbers if completed, so an error occurs; check increment value. 

First line number greater than second. 

Attempt to replace or delete a busy line or subprogram. Typically, this is 
caused by trying to delete an input statement that is still requesting values. 

Matrix not square. The dimensions of an identity matrix or of one used to find 
an inverse or determinant must be the same size. 

Illegal operand in matrix transpose or matrix multiply. The result matrix can't 
be one of the operands. 

Nested keyboard entry statements. 

No binary in memory for STORE BIN or no program in memory for SAVE. 
Check line numbers in SAVE against program in memory. 

Subprogram COM declaration is not consistent with main program. Check 
number, type and dimensions of variables. 

Recursion in single-line DEF FN function. Only subprograms can be called 
recursively. 

Line specified in ON declaration not found. 

File number less than 1 or greater than 10. 

File not currently assigned. Execute an ASSIGN statement for the file, or check 
the accuracy of the file number used. 

Improper mass storage unit specifier. Check the values of the select code, unit 
code and controller address. 

Improper file name. A file name can have 1-6 characters and can't contain a 
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Improper file name. A file name can have 1-6 characters and can't contain a 
colon, quote mark, NULL or CHR$(255). 

Duplicate file name. Choose another name or PURGE the old one. 

Directory overflow. There is a maximum number of files that a mass storage 
medium can hold. A file will have to be removed to add another. 

File name is undefined. Check the spelling. 

Mass Storage ROM is missing. Check to see that the ROM is installed properly. 

Improper file type. Use LOAD for PROG files, ASSIGN and GET on DATA 
files and LOADKEY for KEYS files. 

Physical or logical end-of-file found. Attempting to READ# or PRINT# past 
the end of the file. Compare the data list to the file size. 

Physical or logical end-of-record found in random mode. Compare the data 
list to the record size. 

Defined record size is too small for data item. You can either PURGE and 
RE-CREATE the file with longer records or regroup the data being recorded. 

File is protected or wrong protect code specified. Check to see that the protect 
code is included and spelled properly. 

The number of physical records is greater than 32 767. That's the limit; use 
something smaller. 

Medium overflow (out of user storage space). A file can't be set up because 
there isn't enough space. Use another medium or purge unwanted files. 

Incorrect data type. You can't use GET on a DATA file that doesn't contain a 
program. Use TYP to find out what kind of data the computer is trying to be 
read. 

Excessive rejected tracks during a mass storage initialization. The medium 
can't be initialized. If the medium is a flexible disk, use a different one. If the 
medium is a hard disc, call your HP Sales and Service Office for assistance, to 
determine whether there has been a hardware failure. 

Mass storage parameter less than or equal to 0. Check values of variables. 
Record numbers, record lengths and number of defined records must be posi- 
tive numbers. 
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Inv/alid line number in GET or LINK ooeration. Check line numbers. May be 



'f 



trying to LINK to file that doesn't contain a program. 
Format switch on the disc off. Turn it on. 
Not a disc interface. Check mass storage unit specifier. 
Disc interface power off. Turn it on. 

72 Incorrect controller address, controller power off, or disc time out. Check mass 
storage unit specifier; make sure controller is on. 

73 Incorrect device type in mass storage unit specifer. 

74 Drive missing or power off. 

75 Disc system error, type L. 

76 Incorrect unit code in mass storage unit specifier. 

77 Disc system error, type IP. 
78—79 Reserved for future use. 

80 Cartridge out or door open. Also check to see if interface is connected prop- 
erly. 

8 1 Mass storage device failure. Possible power failure. 

82 Mass storage device not present. Check mass storage unit specifier. 

83 Write protected. Check the write-protection device on the medium or drive. 

84 Record not found. There is a bad spot on the medium. 

85 Mass storage medium is not initialized. 
8b Not a compatible tape cartridge. 

87 Record address error; information can't be read. Hardware failure. Check for a 
dirty read head. 

88 Read data error. Hardware failure. Check for a dirty read head. 

89 Check read error. 

90 Mass storage system error. 

9 1 - 99 Reserved for future use. 

100 Item in print using list is string but image specifier is numeric. 

1 See the Mass Storage Techniques Manual. 
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Item in print using list is numeric but image specifier is string. 

Numeric field specifier wider than printer width. 

Item in print using list has no corresponding image specifier. 

ON KBD or TOPEN not allowed in subprogram. 

Reserved for future use. 

Plotter type specification not recognized. Check spelling of "GRAPHICS", 
"9872A" or "INCREMENTAL". 

Plotter has not been specified. Check select codes. 

No graphics hardware installed in the System 45B. 

LIMIT specifications out of range. 

98036 card improperly configured. 

TDISP not allowed unless peripheral keyboard active. 

TOPEN is active on another select code. 

Reserved for future use. 

Improper select code. 

A negative select code was specified that does not match present bus address- 
ing. 

Parity error. 

Either insufficient input data to satisfy enter list, attempt to ENTER from 
source into source or enter count exhausted without linefeed. 

Integer overflow, or ENTER count greater than 32 767 bytes or 16 383 words. 

Invalid interface register number. (Can only specify 4-7.) 

Improper expression type in READIO, WRITEIO, or STATUS list. 

No linefeed was found to satify % ENTER image specifier, or no linefeed 
record delimiter was found in 512 characters of input. 

Improper image specifier or nesting image specifiers more than 4 levels deep. 

Numeric data was not received for numeric enter list item. 

Repetition of input character more than 32 768 times. 
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Attenrnted to create CONVERT table or EOL seQuence for source or destina- 
tion variable which is locally defined in a subprogram. 

Attempted to delete a nonexistent CONVERT table or EOL sequence. 

I/O error, such as interface card not present, device timeout, interface or 
peripheral failure {Interface FLAG line = 0.), stop key pressed or improper 
interface card type. 

Transfer type specified is incorrect type for interface card. 

A FHS or DMA transfer with no format specifies a count that exceeds th size of 
the variable, or an image specifier indicates more characters than will fit in the 
specified variable. 

A NOFORMAT FHS or DMA type transfer does not start on an odd numbered 
character position, such as A$[3]. 

Interface status error, TRL Character or an EOI was received on an HP-IB 
Interface before ENTER list or image specification was satisfied. 

Reserved for future use. 

Improper argument for OCTAL or DECIMAL function or assembled location. 

Break Table overflow. 

Undefined BASIC label or subprogram name used in IBREAK statement. 

Attempt to write into protected memory; or, attempt to execute instruction not 
in ICOM region. 

Label used in an assembled location not found. 

Doubly-defined entry point or routine. 

Missing ICOM statement. 

Module not found. 

Errors in assembly. 

Attempt to move or delete module containing an active interrupt service 
routine. 

IDUMP specification too large. Resulting dump would be more than 32 768 
elements. 

Routine not found. 



J-8 Error Messages 



Unsatisfied externals. 

Missing COM statement. 

BASIC'S common area does not correspond to assembly module require- 
ments. 

Insufficient number of BASIC COM items. 

Reserved for future use. 

Binaries not allowed in LOAD SUB file. Do LOAD, SAVE, SCRATCH A, GET 
and STORE on the file to get rid of binaries. However, the loaded program 
may not run after the binaries are removed. 

Volume not mounted. Mount it and execute a VOLUME DEVICES ARE state- 
ment. 

Operation not allowed on tape. Only the BKUP file used in DBBACKUP and 
DBRECOVER is allowed on tape. 

Bad status array. It must be defined as integer precision with ^ 10 elements. 
Check spelling and current size. 

Improper data base specified or data base not open. Improper name, or per- 
forming data base operation with invalid name. 

Data set not found. Check set name or number and make sure it is on the 
volume specified in the schema. 

Reserved for future use. 

Data base requires creation. Perform a DBCREATE. 

Reserved for future use. 

Volume name not part of data base. Check spelling. 

Out of available memory for a DBOPEN, DBBACKUP or DBRECOVER. Out 
of read /write memory if executed from main program. Out of special area if 
executed from subprogram, so perform the DBOPEN in the main program. 

Improper or illegal use of maintenance word. Check spelling and leading or 
trailing blanks. 

Data set not created. 

Reserved for future use. 
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Improper backup file. In DBRECOV^ER, backup file has incorrect information 
in header or no primary DBBACKUP/ RECOVER currently in progress (for 
secondary operation). 

Incomplete backup file. More than one volume in backup; probably mounted 
in the wrong order. Start the recovery over. 

Improper utility version number in root file. Rerun Schema Processor to gen- 
erate new root file. 

Corrupt data base — must purge and redefine. Purge root file and run Schema 
Processor. 

Corrupt data base — all sets require erasure. 

Data sets cannot be re-created without root file. 

Operation not allowed while DBOPEN current. Perform a DBCLOSE mode 1. 

Improper set list in DBBACKUP, DBCREATE, DBERASE, DBPURGE or dup- 
licate sets in the set list. 

Reserved for future use. 

Required data set root file not mounted. Mount it and perform a VOLUME 
DEVICES ARE. 

Referenced line not a PACKFMT statement. Make sure line identifier is correct 
and that it references a PACKFMT statement. 

Reserved for future use. 

Insufficient length in a PACK statement, or insufficient current length in an 
UNPACK. Insufficient length in a DBBACKUP or DBRECOVER statement. 

List length > 32 767 in PACK or UNPACK. Array in PACKFMT too large. 
Make sure it is the correct variable; redimension if necessary. 

Numeric conversion error. Improper real number found. Check PACKFMT to 
make sure a REAL or SHORT variable, not INTEGER is being unpacked. 

UNPACK requires a source string of greater length. 

Reserved for future use. 

CCOM area not allocated 

Not allowed when channel is active 
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CMODEL statement required 

Not allowed when trace is active 

Too many characters in CWRITE 

New CCOM size not allowed when channel is active 

98046 card failure 

Insufficient CCOM allocation 

Illegal character in CWRITE of non-TRANSPARENT data 

Not allowed for this CMODEL 

CCONNECT statement required 

Not allowed while Data Comm is suspended 

Improper CSTATUS array 

329 Reserved for future use. 

Lexical table size exceeds array size. 

Improper pointer array*. 

Non-existent dimension specified in MAT REORDER. 

Pointer array contains out-of-range subscript value. 

Pointer array length does not equal number of records. 

Pointer array is not one-dimensioned. 

Number of records (plus twice the number of secondary keys plus twice the 
number of substrings) exceeds 16 383. 

Subscript extends beyond dimensioned maximum length. 

Subscript out-of-range in key specifier. 

Starting location is an out-of-range subscript value. 

Lexical table is too small to include all characters. 

Main lexical table length plus mode section length does not equal specified 
table length. 

This error occurs when data is lost in the process of reordering the array. If this error does not occur, it does not necessarily 
imply that the pointer array contains a permutation. 
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Array is not one-dimensioned or is not integer. 
Lexical mode section pointer out-of-range. 
Lexical table length exceeds 16 383. 
i=99 Reserved for user. 

m Error octal number; octal number 

This error indicates a malfunction in the machine's firmware system. Contact your Sales 
and Service Office. 



I/O Device Errors 

Two error messages can occur when attempting to direct an operation to an I/O device that is 
not ready for use. A printer which is out of paper or no device at a specifed select code are 
examples. The first message that appears is — 



E select code 



If the condition is not corrected, the machine beeps intermittently and the following message 
replaces the first - 

DE select code 



The I/O device can be made usable by correcting the error (loading paper, or changing the 
select code, for example), then executing the READY# command - 

REHDYtt select code 



This command readies the I/O device and the operation which was attempted is attempted 
again. The select code must be specified by an integer. 

If you get an I/O error on select code and the printer is not out of paper, call your Sales and 
Service Office. 

In some cases, such as an interface which is not connected, READY# for that select code may 
not solve the I/O error. In this case, STOP should be pressed to regain control of the compu- 
ter. Be sure to turn the power off before inserting an interface. After the problem is remedied, 
the operation or program can be tried again. 
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If you get an I/O error and you have an ON KBD statement in effect, you must press STOP to 
gain control of the computer. Otherwise, the READY# command will be trapped by ON KBD. 

CSTATUS Element Errors 

1 9 Timeout before connection 

1 1 Clear to Send line false or missing clock 

109 Channel MEMLIMIT overflow 

101 Illegal protocol from remote 

102 Input buffer overflow 

103 Internal buffer overflow 

104 Autodisconnect forced 

105 RETRIES count exceeded 

106 NOACTIVITY timeout 
200 98046 buffer overflow 



Assembly-Time Errors 

Doubly-defined label 

END instruction missing; or module name does not match. 

Expression evaluation error. 

Literal pools full or out of range. 

ICOM region overflow. 

Operand out of range. 

Argument declaration pseudo-instruction out of sequence. 

Incorrect type of operand used. 

Undefined symbol. 
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IMAGE Status Errors 

The following are possible values and meanings of the condition word (first element of the 
status array). After an error, the status array is as follows - 



Element 


Description 


1 


Condition word is non-zero 


2-4 


No change 


5 


DBOPEN mode 


6 


Statement identification number 


7 


Program line number 


8 





9 


Value of the mode parameter 


10 


Integer-for system use only 



Each statement has an identification number. 



Number 


Statement 


401 


DBOPEN 


402 


DBINFO 


403 


DBCLOSE 


404 


DBFIND 


405 


DBGET 


406 


DBUPDATE 


407 


DBPUT 


408 


DBDELETE 



Condition 
Word Value 



Error Description 

Successful execution - no error 

Improper data base name; already have read /write access to the data base 

You may not open additional data bases; five are already opened 

Bad data base name or preceding blanks missing. Don't change the first two 
characters. Data base may not be open. 

DBPUT, DBDELETE and DBUPDATE not allowed in DBOPEN mode 8 

Bad password - grants access to nothing or not to that set. Check spelling. 
Data item, data set, or volume nonexistent or inaccessible. Check spelling and 
DBOPEN password. Volume references must be numeric for DBINFO. 
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Detail data set required 

You lack write access to this data set 

DBPUT or DBUPDATE not allowed on Automatic Master. Check correctness 
of set reference. 

Improper mode in data base statement. DBGET mode 5 bad - specified data 
set lacks chains 

Item specified is not an accessible key item in the specified set. Bad @ 
parameter — must be ■■@; '■ or ■■§ •■ or ■■(!?■■. 

Root file name in disc directory and name in root file are different. Make sure 
root file not moved or renamed. 

Root file version not compatible with current IMAGE/45 statements. Incorrect 
version of Schema Processor used. 

Data base requires creation 

Data or structure information lost. Data base must be erased or redefined. 

Cannot DBOPEN while a DBBACKUP or DBRECOVER is going on. 

End of file on serial DBGET; no entries following the current record. 

Negative record number on directed DBGET. Check record number and spel- 
ling. 

Record number greater than capacity on directed DBGET. Check record 
number and spelling. 

End of chain encountered 

The data set is full 

No current record or the current record is empty; make sure that a current 
record is defined for this set. There is no chain for the key item value. There is 
no entry with the specified key value 

Broken chain. Must UNLOAD the data base. 

DBUPDATE will not alter a key item. Make sure correct key item values are in 
the correct places in the buffer string. 

Duplicate key item value in master not allowed. 
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44 Can't delete a Master entry with non-empty detail chains 

50 Buffer string is too small for requested data. Redimension if necessary. 

53 Argument parameter type incompatible with key field type (DBGET, mode 7 

or DBFIND) or current length of string argument is less than the string length of 
the key item value. 

80 Data set's volume is not on line; or set not created. 

94 Corrupt data base successfully opened in mode 8 

Ixx There is no chain head for path XX 

3xx The automatic master for path xx is full 

4xx The master data set for path xx is not on-line (Applies to DBPUT and DBDE- 

LETE for detail data sets) 

500 Root file volume isn't mounted. 

5xx Needed volume on-line; created data set xx isn't there 
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Appendix Ia 

Maintenance 



Maintenance Agreements 

Service is an important factor when you buy Hewlett-Packard equipment. If you are to get 
maximum use from your equipment, it must be in good working order. An HP Maintenance 
Agreement is the best way to keep your equipment in optimum running condition. 

Consider these important advantages — 

• Fixed Cost — The cost is the same regardless of the number of calls, so it is a figure that 
you can budget. 

• Priority Service — Your Maintenance Agreement assures that you receive priority treat- 
ment, within an agreed-upon response time. 

• On-Site Service — There is no need to package your equipment and return it to HP. Fast 
and efficient modular replacement at your location saves you both time and money. 

• A Complete Package — A single charge covers labor, parts, and transportation. 

• Regular Maintenance — Periodic visits are included, per factory recommendations, to 
keep your equipment in optimum operating condition. 

• Individualized Agreements — Each Maintenance Agreement is tailored to support your 
equipment configuration and your requirements. 

After considering these advantages, we are sure you will see that a Maintenance Agreement is 
an important and cost-effective investment. 

For more information, please opntact your local HP Sales and Service Office. 
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Appendix 1^ 

9835/9845 Compatibility 



System 35 and System 45 assembly language programs are for the most part source code 
compatible. The exceptions to this are noted below. For example, a GET command can be 
used by a System 45 to retrieve source code which has been SAVE'd on a System. 35, and vice 
versa. However, object code files (ILOAD, ISTORE) are not compatible. 

The following items specify the differences between the two assembly language systems. 

1. The following 9835/9845 differences affect source code compatibility - 

• The 9845 has 9 Base_page temporaries; the 9835 has 50. 

• The absolute addresses of the routines within the Rel_math utility are different, and 
must be changed between the 9845 and the 9835. 

• The 9845 has two fewer return stack entries than the 9835. 

• The Get_info utility returns additional information when used with the 9845. The 
number of words returned depends upon the memory size of the machine used — 

- 33 words for machines over 256K 

- 36 words for machines over 320K 

- 39 words for machines over 384K 

Additional space for this information may need to be reserved in assembly language 
programs which are moved to larger machines. 

• The Isr_flag link is not needed in the code that notifies BASIC of an interrupt, on 
the 9845. This link is used only in the 9835 code, and should be removed from any 
code run on the 9845. 

• The keyboards of the 9845 and 9835 differ. Keyboard and printer register opera- 
tions differ also. (See the Assembly Language Quick Reference manual.) 

2. The 9845 has two additional utilities, To_system and Print_no_lf. 

3. The LINES option to the lASSEMBLE statement has been expanded on the 9845 to 
include a negative line number. If a negative number is used, no additional carriage- 
return, linefeed characters are sent after each module has been printed. Of course, if the 
EJECT option has been specified, a formfeed character is sent after each page. 
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4. The 9845 allows symbolic debugging (e.g., IDUMP Test) of all ENT and SUB symbols, 
regardless of whether they appear in assembled code or in ILOAD'ed code. The 9835 
allows symbolic debugging only if the symbols appear in assembled code which is in its 
original, unmoved position in the ICOM region. 

5. lOF and ION have been added as pseudo-instructions in the 9845 Assembly Language. 
They are used to control the automatic setting of indirect bits in generated code. 

6. Rel_to_sho returns or an error number in the A register, for the 9845. 

Note that two processors are used in the 9845 and one is used in the 9835. (For non-ISR 
assembly language code, the two 9845 processors function together as a single unit to maintain 
compatibility with the 9835.) The advantages of two processors are - 

• Overlapped I/O (in the OVERLAP mode) can in some cases bring about speed en- 
hancements. 

• An ISR (interrupt service routine) can be executed simultaneously with a BASIC pro- 
gram. 
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AAR 3:18;B:1, 12-14 

Abortive access 7:11 

ABR 3:18;B:1, 12-14 

ABS function 5:23 

Absolute expression 4:31,32 

Absolute location 3:11;4:22,23 

Access: 

abortive 7:11 

asynchronous 7:11,27 

granting 7:10-13 

synchronous 7:11 

Accumulators: 

General 3:2,12,13,18;4:24;E:1 

map 3:3 

ACS function 5:23 

ADA 3:13;5:2;B:1, 12-14 

ADB 3:13;5:2;B:1, 12-14 

Addition: 

General 3:13 

BCD 5:9,10 

integer 5:1,2,3 

Address, machine 4:34 

Addressing: 

General 3:11 

indirect 3:12;7:18-21 

Alphanumeric raster 10:2 

AND: 

instruction 3:19;B:1,12-14 

operation 5:23 

ANY 6:6,24;C:1 

Arguments: 

changing values of 6:18 

passing from BASIC 6:3,12 

system information about 6:7,8 

Arithmetic: 

General 5:1 

BCD 3:23-25;5:l,8 

integer 5:1,2-6 

utilities 5:1,21-27 

Arrays: 

changing values in 6:20,21 

identifiers 6:26,27 

obtaining information on 6:8,9 

retrieving elements from 6:14,15 

retrieving substrings from 6:16,17 

system information about 6:7 



ASC declaration 8:15;D:3 

ASCII character set A: 1 -3 

ASMB file-type 2:13,16,18 

ASN function 5:23 

Assembled location 1:5;D:1 

Assembling process 4:13 

Assembly: 

conditional, defined 1:5 

Execution and Development ROM . . 1:1 

Execution ROM 1:1 

ASSIGN 7:39-42 

Asynchronous access 7:11,27 

ATN function 5:23 



b 



B, defined 1:7 

Backplane 7:1,2 

Base page 3:6, 1 1 

BASIC: 

General 2:2-7;6:18;8:7 

assembly language 

extensions 2:8;D:1— 4 

assembly source entry 2:9 

branching on interrupts 7:27 

calling assembly language 2:1 

common 6:23 

comparison of expressions 4:32 

comparison of operators 4:33 

drivers 2:3 

end-of-line branches 7:8 

labels 4:1,2,4,5 

passing variables 1:6 

relation to assembly language 4:1 

routines 8:8,9 

subprograms 7:32,40;8:9,12,13 

variables: 

General 6:18;8:8 

structure 3:8 

D^^L^: 

General 3:9;5:7 

addition 5:9,10 

arithmetic 3:23-25;5:l,8 

division 3:25;5:15-21 



2 Subject Index 



Math group 3:10,23-25 

multiplication 3:25;5:13-15 

normalization 3:23;5:8,12 

registers 5:7,8 

rounding 5: 12 

subtraction 5:9-10 

Beep signal 7:53 

BIN declaration 8:15;D:3 

Binary Processor Chip (BPC) 3:1,2 

Bit patterns and timings, machine 

instructions B:12 

Blank lines, in listings 4:16,18 

Blind parameters 6:6 

Boolean operations 3:19 

Booth's algorithm 3:13;B:4 

Braces (in syntax), explained 1:7 

Brackets (in syntax), explained 1:7 

Branch group 3:10,14 

Branching: 

General 3:14 

end-of-line 7:8 

interrupt, prioritizing 7:30,31 

on interrupts 7:27-33 

Break points 8:7 

BSS 4:8,26,30;C:1 

Buffers, device 7:33—35,38 

Bus, I/O 3:26 

Bus cycles, I/O 3:1,11;8:21 

Busy bits l:5;6:26-28 

Busy utility 4:38;6,26-28;F:l 

Buzzwords 1:5-7 

Bytes: 

General 3:20-22 

definition 1:5 

pointers 4:24 

retrieving from BASIC 6:15-17 



c 

CALL 2:13;6:1,2 

CBL 3:20-22;B:2, 12-14 

CBU 3:22;B:2,12-14 

CDC 3:25;5:9;B:2,12-14 

CLA 3:19;B:2,12-14 

CLB 3:19;B:2,12-14 

Clearing full words 10:15-18 

Clock times B:13 

CLR 3:12;B:2,12-14 

CMA 3:19;B:2,12-14 

CMB 3:19;B:2,12-14 

CMX 3:24;5:10;B:2,12-14 



CMY 3:25;5:10;B:2,12-14 

Code: 

object 2:l-3,6-8,13;4:7,13 

source 2:l-6;4:3-6,13 

COM: 

pseudo-instruction 4:12;6:24;C:1 

statement 2:14;6:9,23-25 

Commands: 

EDIT 4:2 

SCRATCH A 2:15 

SCRATCH C 2:15 

Comments, in assembly source 4:5 

Common 6:23 

Compatibility, 9835/9845 L:l,2 

Complement: 

one's 3:19 

ten's 5:9,10 

two's 3:8,9,13;5:2 

Conditional assembly: 

General 4:13,19 

definition 1:5 

flags 4:20 

Control codes, graphics 10:5-7,11 

Control of indirection 4:13,22 

Control registers 7:2,3 

COS function 5:23 

CPA 3:15;B:2,12-14 

CPB 3:15;B:2,12-14 

Current page 3:6, 1 1 

Cursor operations 10:5,22-25 

Cursor types 10:22,23 

d 

DAT 4:9,10;C:1 

Data: 

generators 4:9 — 11 

locations 8:11,12 

structures 3:8,9 

types 3:8;7:48 

DBL 3:22;B:2,12-14 

DBU 3:22;B:2,12-14 

DDR 3:26;B:2,12-14 

Debugging 2:l,2;4:15,19,23;8:l-22 

DEC declaration 8:15;D:3 

DECIMAL 2:10;5:23;8:1,17-19;D:1 

Decimal Carry flag 3:23,25;8:20 

Declarations: 

ANY 6:6,24;C:1 

ASC 8:15;D:3 

BIN 8:15;D:3 
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DEC 8:15;D:3 

FIL 6:4,24;C:1 

HEX 8:15;D:3 

INT 6:4,24;C:1 

OCT 8:15;D:3 

REL 6:4,24;C:2 

SHO 6:4,24;C:2 

STR 6:4,5,24;C:2 

Defined record 7:43 

Demonstration cartridge 1:2;2:8;I:1 

Device buffers 7:33-35,38 

DIR 3:26;4:37;B:2,12-14 

Direct memory access (DMA): 

General 3:26;7:1, 10-13,22-26 

lockout time B: 14 

registers 4:24;7:22 

timings 8:13,14 

transfers 7:23-26 

DISABLE 7:33 

DIV function 5:23 

Division: 

BCD 3:25;5:15-21 

integer 5:4,5 

DMA instruction 3:26;7:23;B:2, 12-14 

DMA string input example 

program H: 12 - 15 

DMA string output example 

program H:10 — 12 

Dot matrix, explained 1:7 

DROUND 5:23 

DRS 3:24;B:3,12-14 

DSZ 3:16;B:3,12-14 

Dumps 8:14 



ERRM$ 9:4 

ERRN 5:23;9:4 

Error_exit utility 4:38;9:3,4;F:1 

Error labels 1:2 

Errors: 

assembly-time 9:1,2 

complete listing J: 1 - 15 

mainframe J: 1 - 1 1 

messages: 

General 9:1 

assembly-time 9:8,9;J:12 

run-time 9:5 — 7 

IMAGE status J:13-15 

I/O device J:ll 

processing 9:1-4 

run-time 9:1,2,3 

syntax-time 9:1,2 

EXE 3:27;B:3,12-14 

EXIT GRAPHICS 10:2 

EXOR 5:23 

EXP function 5:23 

Expressions: 

General 4:31-33;8:31 

absolute 4:31,32 

octal, defined 1:6 

relocatable 4:31 

type of result 4:32 

EXT 4:12,33,34,37;C:1 

Extend flag 3:13,15-17;7:17;8:20 

Extended Math Chip (EMC) 3:1,2 

External 4:33 
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EDIT 4:2 

EIR 3:26;4:37;B:3,12-14 

EJECT option, lASSEMBLE 

statement 4:13,16,17;D:2 

Ellipses (in syntax), explained 1:7 

ENABLE 7:33 

END pseudo- 
instruction 2:5,11,12;4:7,12;C:1 

End_isr_high 7:9,10 

End_isr_low 7:9,10 

ENT 4:33,34;C:1 

Entry points 4:33 

EQU 4:12,26,28;C:1 

Equipment supplied 1:2 

ERRL 5:23;9:4 



FDV 3:25;5:17-19;B:3,12-14 

FIL 6:4,24;C:1 

File marks 7:47,48 

Files: 

ASMB-type 2:13,16,18 

descriptor 7:39,40 

names 2:11 

OPRM-type 2:13,16,18 

Flag line 3:26;7:4,5,6 

Flags: 

Conditional assembly 4:20 

Decimal Carry 3:23,25;8:20 

Extend 3:13,15-17;7:17;8:20 

Overflow 3:13,15-17;7:17;8:20 

FMP 3:25;5:13-15;B:3, 12-14 

FRACT 5:23 

Full-precision numbers 3:9;4:25;7:45 
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Functions: 

ABS 5:23 

ACS 5:23 

ASN 5:23 

ATN 5:23 

COS 5:23 

DECIMAL . . . 2:10;5:23;8:1,17-19;D:1 

DIV 5:23 

DROUND 5:23 

ERRL 5:23;9:4 

ERRM$ 9:4 

ERRN 5:23;9:4 

EXP 5:23 

FRACT 5:23 

lADR 2:10;5:23;8;1,17,19;D:1 

IMEM 2:10;5:23;8:1,17,19,20;D:3 

INT 5:23 

LGT 5:23 

LOG 5:23 

OCTAL . . . 2:10;5:23;8:1,17,18,19;D:4 

PI 5:23 

PROUND 5:23 

RES 5:23 

RND 5:23 

SGN 5:23 

SIN 5:23 

SQR 5:23 

TAN 5:23 

TYP 5:23 

FXA 3:25;5:12;B:3,12-14 
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Get_bytes Utility .. 4:38;6:12,15,16,24;F:1 
Get_elem_bytes 

utility 4:38;6:12,16,17,24;F:1 

Get_element utility 4:38;6:12,14,15,24;F:1 

Get_file_info utility 4:38;7:40,41;F:1 

Getjnfo utility 4:38;6:8-12,24;F:l 

Get_value utility 4:38;6:12,13,24;F:1 

Glossary 1:5-7 

GRAPHICS 10:2 

Graphics: 

comprehensive example 10:25 

cursors 10:22,23 

displaying 10:2,3 

exiting 10:2,3 

memory 10:3,4 

operations 10:5—27 

operations, general algorithm 10:6 

option 10:1 



raster 10:2,3 

select code 10:1 

Graphics hardware, checking for 10:5 

Groups: 

BCD Math 3:10,23-25 

Branch 3:10,14 

I/O 3:10,26 

Integer Math 3:10,13 

Load/Store 3:10,12 

Logical 3:10,19 

Miscellaneous 3:10,27 

Shift/Rotate 3:10,18 

Stack 3:10,20 

Test/ Alter /Branch 3:10,16,17 

Test/Branch 3:10,15 

h 

Handshake string input example 

program H:3,4 

Handshake string output example 

program H:l,2 

HED 4:18,19;C:1 

HEX declaration 8:15;D:3 

HP-IB output /input drivers example 

program H:15 — 18 



1 

lADR 2:10;5:23;8:1,17,19;D:1 

lASSEMBLE 2:6,10;4:13,19,23;D:2 

lASSEMBLE ALL 4:13;D:2 

IBREAK 2:10;3:7;8:1,7-11;D:2 

IBREAK ALL 8:1,12,13;D:2 

IBREAK DATA 8:1,11,12;D:2 

ICALL 2:6,10,13;3:7;4:34;6:1-6;D:2 

ICHANGE 2:10;8:1,21;D:3 

ICOM 2:6,10,13-16;D:3 

ICOM region .. 2:13-18;3:4;4:8,23,34;6:2 

IDELETE 2:10,13,15,17;D:3 

IDELETE ALL 2:15,17;4:23;D:3 

IDUMP 2:10;8:1,14,15;D:3 

IF conditional 4:20 

IFA 4:20;C:1 

IFB 4:20;C:1 

IFC 4:20;C:1 

IFD 4:20;C:1 

IFE 4:20;C:1 

IFF 4:20;C:1 
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IFG 4:20;C:1 

IFH 4:20;C:1 

IFP 4:20,21;C:1 

ILOAD 2:8,10,12, 18;4:7;D:3 

IMEM 2:10;5:23;8:1,17,19,20;D:3 

Indirect addressing: 

General 3:12;4:22,23 

inlSRs 7:18-21 

Indirection, control of 4:13,22 

INORMAL 2:10;8:1,10,13;D:4 

Input cycle, explained 3:1 

I/O: 

bus 3:26 

bus cycles 3:1,1 1;8:21 

expediting 7:53,54 

group 3:10,26 

interrupt 7:1,7-21 

operations, relation to busy 

bits 6:26-29 

programmed 7:1 

registers 3:2;4:24;7:2,3 

sample programs H: 1 -21 

Input-Output Controller (IOC) 3:1,2 

Instructions: 

individual execution of 8:3 

machine: 

General 3:10-27;B:1-14 

12-14 
12-14 
12-14 
12-14 
12-14 
...5:7 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 



AAR 3:18;B:1 

ABR 3:18;B:1 

ADA 3:13;5:2;B:1 

ADB 3:13;5:2;B:1 

AND 3:19;B:1 

arithmetic 

CBL 3:20-22;B:2 

CBU 3:22;B:2 

CDC 3:25;5:9;B:2 

CLA 3:19;B:2 

CLB 3:19;B:2 

CLR 3:12;B:2 

CMA 3:19;B:2 

CMB 3:19;B:2 

CMX 3:24;5:10;B:2 

CMY 3:25;5:10;B:2 

CPA 3:15;B:2 

CPB 3:15;B:2 

DBL 3:22;B:2 

DBU 3:22;B:2 

DDR 3:26;B:2 

DIR 3:26;4:37;B:2 

DMA 3:26;B:2 

DRS 3:24;B:3 

DSZ 3:16;B:3 



EIR 3:26;4:37;B:3 

EQU 4:12,26 

EXE 3:27;B:3 

FDV .... 3:25;5:17-19;B:3 
FMP ....3:25;5:13-15;B:3 

FXA 3:25;5:12;B:3 

groups 

lOR 3:19;B:4 

ISZ 3:16;B:4 

JMP 3:14;B:4 

JSM 3:6,14;6:9;B:4 

LDA 3:12,27;B:4 

LDB 3:12-4;B:4 

MLY 3:24;5:18;B:4 

MPY '3:13;'B:4 

MRX 3:23;5:11,12;B:5 

MRY 3:24;5:11,12;B:5 

MWA 3:25;5:13;B:5 

NOP 3:27;B:5 

NRM 3:24;5:12;B:5 

operands 



PBC 3:21,22;B 

PBD 3:21,22;B 

PWC 3:20,22;B 

PWD 3:20,22;B 

RAL 3:18;B 

PJ^R 3:18;B 

RBL 3:18;B 

RBR 3:18;B 

RET ....2:5;3:6,14;6:2;B 

RIA 3:15;B 

RIB 3:15;B 

RLA 3:17;B 

RLB 3:17;B 

RZA 3:15;B 

RZB 3:15;B 

SAL 3:18;B 

SAM 3:16;B 

SAP 3:16;B 

SAR 3:11, 18;B 

SBL 3:18;B 

SBM 3:16;B 

SBP 3:16;B 

SBR 3:18;5:15;B 

SDC 3:25;B 

SDI 3:26;7:22;B 

SDO 3:26;7:22;B 

SDS 3:25;5:9;B 

SEC 3:17;B 

SES 3:17;B 

SFC 3:26;7:5;B 

SFS 3:26;7:5;B 



28;C:1 
12-14 
12-14 
12-14 
12-14 
..3:10 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
..3:10 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
12-14 
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SHC 3:15;B:9,12-14 

SHS 3:15;B:9,12-14 

SIA 3:15;B:9,12-14 

SIB 3:15;B:9,12-14 

SLA 3:16;B:9,12-14 

SLB 3:16;B:9,12-14 

SOC 3:17;B:9,12-14 

SOS 3:17;B:10,12-14 

SSC 3:26;7:5;B:10,12-14 

SSS 3:26;7:5;B:10,12-14 

STA 3:12;B:10,12-14 

STB 3:12;B:10,12-14 

SZA 3:15;B:10,12-14 

SZB 3:15;B:10,12-14 

TCA 3:13;5:2;B:10,12-14 

TCB 3:13;5:2;B:10,12-14 

WBC 3:21,22;B:11, 12-14 

WBD 3:21,22;B:11, 12-14 

WWC 3:20,22;B:11, 12-14 

WWD 3:20,22;B:11, 12-14 

XFR 3:12;4:29;B:11, 12-14 

patching 8:21 

processor 3:1 

pseudo-: 

General 4:3;C:1,2 

ANY 6:6,24;C:1 

BSS 4:8,26,30;C:1 

COM 4:12;6:24;C:1 

DAT 4:9,10;C:1 

END 2:5,11, 12;4:7,12;C:1 

ENT 4:33,34;C:1 

EQU 4:12,26,28;C:1 

EXT 4:12,33,34,37;C:1 

HED 4:18,19;C:1 

IFA 4:20;C:1 

IFB 4:20;C:1 

IPC 4:20;C:1 

IFD 4:20;C:1 

IFE 4:20;C:1 

IFF 4:20;C:1 

IFG 4:20;C:1 

IFH 4:20;C:1 

IFP 4:20,21;C:1 

LIT 4:30;C:1 

LST 4:14,19;C:1 

NAM 2:5,11;4:7,12;C:2 

non-listable 4: 19 

REP 4:12;C:2 

SET 4:27;C:2 

SKP 4:16,17,19;C:2 

SPC 4:18,19;C:2 

SUB 2:5;4:12;6:2,3;C:2 



UNL 4:15,19;C:2 

XIF 4:20,21;C:2 

repeating 4:12 

INT: 

declaration 6:4,24;C:1 

function 5:23 

Int_to_rel utility 4:38;5:26;F:1 

INTEGER 3:8 

Integer : 

addition 5:1,2,3 

arithmetic 5:1,2-6 

multi-word 5:5,6 

division 5:4,5 

multiplication 5:1,3,4 

subtraction 5:1,3 

Integer Math group 3:10,13 

Integers: 

General 3:8;5:2,24,25;6:8 

octal 4:10 

structure 3:8;5:2 

Interfaces: 

General 7:2,4,22 

98032 (GPIO) 7:3,16,22;G:1-14 

98033 (BCD) H:3,4,7-9 

98034 (HP-IB) H:15-18 

98035 (Clock) H:l-4,19,20 

98036 (Serial) H:l-9 

Interrupt I/O 7:1-21 

Interrupt service routines: 

General 2:15;3:7;7:7-10 

called from BASIC 7:27-33 

definition 1:6 

linkage 7:9,10,30 

reserved symbols 4:24,25 

state in 7:17 

Interrupt string input example 

program H:7-9 

Interrupt string output example 

program H:5-7 

Interrupts: 

disabling 7:15,16 

enabling 7:19,20 

execution time B:13 

lockout time B:13 

related machine instructions 3:26 

signalling 7:28,29 

lOF 4:13,22;C:1 

ION 4:13,22;C:1 

lOR 3:19;B:4,12-14 

IPAUSE OFF 2:10;8:1,7;D:4 

IPAUSE ON 2:10;8:1,4-7;D:4 

ISOURCE 2:5,8,9;4:2,5,6;D:4 
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ior\, ueiiiieu i:b 

Isr_access utility 4:38;7:13,14,15;F:1 

ISTORE 2:7,10,13,17,18;4:7;D:4 

ISTORE ALL 2:18;D:4 

ISZ 3:16;B:4,12-14 



m 



J 



JMP 
JSM 



3:14;B:4,12-14 

3:6,14;6:9;B:4,12-14 



I 



Labels: 

assembly language 4:3—6 

BASIC 4:1,2,4,5 

LDA 3:12,27;B:4,12-14 

LDB 3:12;B:4,12-14 

LGT function 5:23 

Line drawing 10:27 

Line drawing routine. Demonstration 

cartridge 10:27-30 

Lines: 

blank, in listings 4:16,18 

Flag 3:26;7:4,5,6 

Status 3:26;7:4,5,6 

LINES option, lASSEMBLE 

statement 4:13,16;D:2 

LIST option, lASSEMBLE 

statement 4:13,14;D:2 

Listing: 

General 4:14,15 

directives 4: 13 

LIT 4:30;C:1 

Literals: 

General 4:27,28 

as data generators 4:10 

evaluation of 4:27,28 

form of 4:27;D:4 

nesting 4:28,29 

nonsensical use of 4:29,30 

pools 4:27,30 

Load/Store group 3:10,12 

Lockout times B:14 

LOG function 5:23 

Logical: 

record 7:43 

group 3:10,19 

operations 3:19 

LST 4:14,19;C:1 



Machine address 4:34 

Machine architecture 3:1-7 

Machine instructions 3:10 -27;B: 1-14 

Maintenance agreements K:l 

Mantissa shifting 3:23,24 

Manual: 

Assembly Development ROM 1:2 

Assembly Execution ROM 1:2 

Assembly Language Quick 

Reference 1:2;7:19 

BASIC Language Interfacing 

Concepts 1:2;7:1,2 

structure 1:2 

Mass storage: 

General 2:2,12;7:33 

Descriptor (MSD) 7:34 

reading from 7:33 

Transfer Identifier (MSTID) .... 7:34,35 

unit specifier (msus) 1:6; 7:34 

writing to 7:37-39 

MASS STORAGE IS 1:6;7:33,34 

MAX 5:23 

Memory: 

General 4:8 

dumps 8:14 

general organization 3:4 

graphics 10:3,4 

map 3:3,5;E:2 

protected 3:6;8:12,22 

read/write 1:1 

reserved 1:1;3:4,6 

MIN 5:23 

Miscellaneous group, machine 

instructions 3:10,27 

MLY 3:24;5:18;B.4,12-14 

Mm_read_start utility . . . 4:38;7:33-35;F:l 
Mm_read_xfer utility 4:38;7:33-35,36;F:l 
Mm_write_start utility 4:38;7:33,37,38;F:1 
Mm_write_test utility . 4:38;7:33,38,39;F:1 

MOD operation 5:23 

Modules: 

General 2:16 

creation 2:11;4:7 

definition .• 2:3 

names 2:11,12;4:16 

object 1:6;4:7,8 

reassembly 4:23 

source 1:7;4:7,8,13 

storage 2:12;4:8 

MPY 3:13;B:4,12-14 
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MRX 3:23;5:11,12;B:5,12-14 

MRY 3:24;5:11,12;B:5,12-14 

Multiplication: 

BCD 5:13-15 

integer 5:1,3,4 

MWA 3:25;5:13;B:5,12-14 



n 

NAM 2:5,11;4:7,12;C:2 

Names, module 2:11,12;4:16 

Nesting subroutine calls 3:6,7 

NOP 3:27;B:5,12-14 

Normalization 5:8,12 

NOT operation 5:23 

NRM 3:24;5:12;B:5,12-14 

Numbers: 

full-precision 3:9;4:35;7:45 

integer precision 3:8; 7:45 

octal 1:6 

short-precision 3:9;4:35;7:45 



P 



o 



Object: 

code 2:l-3,6-8,13;4:7,13 

modules 1:6;4:7,8 

OCT declaration 8:15;D:3 

OCTAL 2:10;5:23;8:1,17,18,19;D:4 

Octal expression, defined 1:6 

OFF INT 2:10;7:32,33 

ON ERROR 9:3,4 

ON INT 2:10;7:27,28,30-32 

One's complement 3:19 

Operands 3:10 

Operating system 7:10 

Operations: 

AND 5:23 

EXOR 5:23 

Logical 3:19 

MOD 5:23 

NOT 5:23 

OR 5:23 

Order of 4:33 

OPRM file-type 2:13,16,18 

OR 5:23 

Output cycle, explained 3:1 

Overflow condition, integer arithmetic 5:2,3 

Overflow flag 3:13,15-17;7:17;8:20 

Overlap mode 6:27 



Page: 

base 3:6;B:13 

current 3:6;B:13 

definition 3:6 

end control 4:17 

format, listings 4:16 

headings, listings 4:16,18 

length, listings 4:16,17 

Parameters: 

blind 6:6 

in SUB pseudo-instruction 6:4 

Pausing 8:3,4,7 

PBC 3:21,22;B:6,12-14 

PBD 3:21,22;B:6,12-14 

Physical record 7:43 

PI 5-23 

Pixel 1:7;10:1,3,4,7-10 

Pixels, writing individual 10:7-10 

Pointers, stack 3:2,20;4:24 

Pools, literal 4:27,30 

Predefined symbols 4:24,25;E:1 

Print_no_lf utility .... 4:38;7:48,52,53;F:1 
Print_string 

utility 4:29,38;7:48,50-52;F:l 

Printer_select utility 4:38;7:49,50;F:1 

Priorities, for select codes 7:8 

Processors: 

General 3:1,2 

Binary Processor Chip (BPC) .... 3:1,2 

bus 3:1 

Extended Math Chip (EMC) 3:1,2 

Input-Output Controller (IOC) ... 3:1,2 

instructions 3:1 

Programmed I/O 7:1 

Programs: 

assembly language, developing . . . 2:1,2 

counter 3:2;4:24 

counter, map 3:3 

creation 2:1 -3,4-8 

definition 2:3 

entry 2:8,9;4:1 

stepping 8:22 

Protected memory 3:6;8:12,22 

PROUND 5:23 

Pseudo-instructions 4:3; C: 1,2 

Put_bytes utility . . . 4:38;6:18,20,21,24;F:1 
Put_elem_bytes 

utility 4:38;6:18,22-24;F:1 

Put_element utility 4:38;6:18,19,20,24;F:1 

Put_file_info utility 4:38;7:41,42;F:1 

Put_value utility 4:38;6:18,19,24;F:1 
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PWC 3:20,22;B:6,12-14 

PWD 3:20,22;B:6,12-14 



RAL 3:18;B:6,12-14 

RAR 3:18;B:6,12-14 

Raster: 

alphanumeric 10:2 

graphics 10:2-4 

RBL 3:18;B:6,12-14 

RBR 3:18;B:6,12-14 

Read busy bit ..__ = . = __.,...,,,.. 6:26 
Real time clock example program H: 19—21 

Record boundaries 7:44 

Record types 7:43 

Reading full words 10:18-21 

REDIM 6:12 

Registers: 

General 3:2 

arithmetic 4:24;5:15-17;E:1 

BCD 5:7,8 

control 7:2,3 

DMA 4:24;7:22 

DMA, map 3:3 

external 3:4 

I/O 7:2,3 

internal 3:2 

internal, map 3:3 

map 3:3 

Peripheral Address (Pa) 7:3,4,10 

preservation by ISRs 7:17 

stack 3:20 

status 7:3 

timing B:13,14 

REL 6:4,24;C:2 

Rel_math utility 4:38;5:21-24;F:1 

Rel_to_int utility 4:38;5:24,25;F:1 

Rel_to_sho utility 4:38;5:25,26;F:1 

Relocatable expression 4:31,32 

Relocatable location 3:11;4:22 

Relocation 4:22,23 

REP 4:12;C:2 

RES function 5:23 

RET 2:5;3:6,14;6:2;B:7,12-14 

RETURN 7:27 

RIA 3:15;B:7,12-14 

RIB 3:15;B:7,12-14 

RLA 3;17;B:7,12-14 

RLB 3:17;B:7,12-14 

RND function 5:23 



ROMs: 

Assembly Execution 1:1,3 

Assembly Execution and 

Development 1:1,3,4 

Graphics 10:1 

installation 1:3,4 

requirements of others 2:14 

Rotation 3:18;B:6,7 

Routines: 

BASIC 8:8,9 

definition 2:3 

names 2:11,12 

RZA 3:15;B:7,12-14 

RZB 3:15;B:7,12-14 



S 

SAL 3:18;B:7,12-14 

SAM 3:16;B:7,12-14 

SAP 3:16;B:7,12-14 

SAR 3:11,18;B:8,12-14 

SBL 3:18;B:8,12-14 

SBM 3:16;B:8,12-14 

SBP 3:16;B:8,12-14 

SBR 3:18;5:15;B:8,12-14 

SCRATCH A 2:15 

SCRATCH C 2:15 

SDC 3:25;B:8,12-14 

SDI 3:26;7:22;B:8,12-14 

SDO 3:26;7:22;B:8,12-14 

SDS 3:25;5:9;B:8,12-14 

SEC 3:17;B:8,12-14 

Select code, graphics 10:1 

Select codes, priorities 7:8 

SES 3:17;B:8,12-14 

SET 4:27;C:2 

SFC 3:26;7:5;B:9,12-14 

SFS 3:26;7:5;B:9,12-14 

SGN function 5:23 

SHC 3:15;B:9,12-14 

Shift/Rotate group 3:10,18 

Shifting, mantissa 3:23-25 

SHO 6:4,24;C:2 

Sho_to_rel utility 4:38;5:27;F:1 

Short-precision numbers .... 3:9;4:35;7:45 

SHS 3:15;B:9,12-14 

SIA 3:15;B:9,12-14 

SIB 3:15;B:9, 12-14 

Sign-magnitude format 5:9 

Signalling interrupts 7:28,29 

SIN function 5:23 
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SKP 4:16,17,19;C:2 

SLA 3:16;B:9,12-14 

SLB 3:16;B:9,12-14 

SOC 3:17;B:9,12-14 

SOS 3:17;B:10,12-14 

Source: 

code 2:l-6;4:3-6,13 

listing control 4:14-19 

modules 1:7;4:7,8,13 

Space dependent mode 4:6 

SPC 4:18,19;C:2 

SQR function 5:23 

SSC 3:26;7:5;B:10,12-14 

SSS 3:26;7:5;B:10,12-14 

STA 3:12;B:10,12-14 

Stack group 3:10,20 

Stack group, in ISRs 7:18,19 

Stacks: 

General 3:20 

pointers: 

General 3:2,20 

map 3:3 

registers 3:20 

Statements, BASIC: 

ASSIGN 7:39-42 

CALL 2:13;6:1,2 

COM 2:14;6:9,23-25 

DISABLE 7:33 

EDIT 4:2 

ENABLE 7:33 

lASSEMBLE . . . 2:6,10;4:13,19,23;D.2 

lASSEMBLE ALL 4:13;D:2 

IBREAK 2:10;3:7;8:1,7-11;D:2 

IBREAK ALL 8:1,12,13;D:2 

IBREAK DATA 8:1,11,12;D:2 

ICALL . . 2:6,10,13;3:7;4:34;6:1-6;D:2 

ICHANGE 2:10;8:1,21;D:3 

ICOM 2:6,10,13-16;D:3 

IDELETE 2:10,13,15,17;D:3 

IDELETE ALL 2:15,17;4:23;D:3 

IDUMP 2:10;8:1,14,15;D:3 

ILOAD 2:8,10,12,18;4:7;D:3 

INORMAL 2:10;8:1,10,13;D:4 

IPAUSE OFF 2:10;8:1,7;D:4 

IPAUSE ON 2:10;8:1,4-7;D:4 

ISOURCE 2:5,8,9;4:2,5,6;D:4 

ISTORE 2:7,10,13, 17,18;4:7;D:4 

ISTOREALL 2:18;D:4 

MASS STORAGE IS 1:6;7:33,34 

OFF INT 2:10;7:32,33 

ON ERROR 9:3,4 

ON INT 2:10;7:27,28,30-32 



REDIM 6:12 

RETURN 7:27 

SUBEND 7:27 

SUBEXIT '. ... 7:27 

Status line 3:26;7:4,5,6 

Status registers 7:3 

STB 3:12;B:10,12-14 

Stepping programs 8:3-14 

STR 6:4,5,24;C:2 

Strings: 

General 3:8;7:46 

as data generators 6:12,13 

SUB pseudo-instruction 2:5;4:12;6:2,3;C:2 

SUBEND 7:27 

SUBEXIT 7:27 

Subprograms, BASIC . . . 7:32,40;8:9,12,13 

Subroutines 3:6,14 

Substrings: 

changing value of 6:22-24 

retrieving 6:15-17 

retrieving from arrays 6:16,17 

Subtraction, integer 5:1,3 

Symbolic operations 4:25-33 

Symbols: 

General 4:24 

address of 8: 19 

defining 4:26,27 

external 4:33,34 

predefined 4:24,25 

Synchronous access 7:11 

Syntax, fundamental 1:7 

System 35/System 45 compatibility . L:l,2 

SZA 3:15;B:10,12-14 

SZB 3:15;B:10,12-14 

t 

TAN function 5:23 

Tape cartridge. Demonstration . . 1:2;2:8;I:1 

TCA 3:13;5:2;B:10,12-14 

TCB 3:13;5:2;B:10,12-14 

Ten's complement 5:9,10 

Test/ Alter/ Branch group 3:10,16,17 

Test/Branch group 3:10,15 

Timings: 

clock B:13 

execution B:13,14 

lockout B:14 

To_system utility 4:38;6:28,29;F:1 

Transfers, DMA 7:23-26 
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Two's complement 3:8,9, 13;5:2 

TYP function 5:23 

Typing aids, demonstration cartridge . 1:1-3 



u 

UNL 4:15,19;C:2 

Utilities: 

General 4:36,37 

Arithmetic 5:1,21 -27 

Arithmetic, operand registers 3:4 

Busy 4:38;6:26,27,28;F:1 

Error_exit 4:38;9:3,4;F:1 

Execution of 8:5 

Get_bytes 4:38;6:12,15,16,24;F:1 

Get_elem_bytes 4:38;6:12,16,17,24;F:1 
Get_element . . 4:38;6:12,14,15,24;F:1 

Get_file_info 4:38;7:40,41;F:1 

Getjnfo 4:38;6:8-12,24;F:l 

Get_value 4:38;6:12,13,24;F:1 

Int_to_rel 4:38;5:26;F:1 

Isr_access 4:38;7:13,14,15;F:1 

Mm_read_start 4:38;7:33-35;F:l 

Mm_read_xfer . . 4:38;7:33-35,36;F:l 
Mm_write_start . Nt:38;7:33,37,38;F:l 
xMm_write_test . . . 4:38;7:33,38,39;F:1 

Print_no_lf 4:38;7:48,52,53;F:1 

Print_string .. 4:29,38;7:48,50-52;F:l 

Printer_select 4:38;7:49,50;F:1 

Put_bytes 4:38;6:18,20,21,24;F:1 

Put_elem_bytes . 4:38;6:18,22-24;F:1 
Put_element . . 4:38;6:18,19,20,24;F:1 

Put_file_info 4:38;7:41,42;F:1 

Put_value 4:38;6:18,19,24;F:1 

Rel_math 4:38;5:21-24;F:1 

Rel_to_int 4:38;5:24,25;F:1 

Rel_to_sho 4:38;5:25,26;F:1 

Reserved symbols 4:25 

Sho_to_rel 4:38;5:27;F:1 

To_system 4:38;6:28,29;F:1 

Writing G:l,2 



W 

WBC 3:21,22;B:11-14 

WBD 3:21,22;B:11-14 

Word: 

General 3:22 

defined 1:7 

transfers 3:12;B:11 

Words: 

clearing 10:15-18 

reading 10:18-21 

writing 10:11-14 

Write busy bit 6:26 

Writing full words 10:11-14 

Writing individual pixels 10:7-10 

WWC 3:20,22;B:11-14 

WWD 3:20,22;B:11-14 



X 

XFR 3:12;4:29;B:11-14 

XIF 4:20,21;C:2 

XREF option, lASSEMBLE 

statement 4:13;D:2 



V 

Value checking 8:17—20 

Variables: 

General 4:8 

BASIC 3:8;6:18;8:8 

retrieving values from 6:12,13 

value checking 5:17—20 



Your Comments, Please. 



Your comments assist us in improving the usefulness of our publications; they are an important 
part of the inputs used in preparing updates to the publications. 

In order to write this manual, we made certain assumptions about your computer background. 
By completing and returning the comments card on the following page you can assist us in 
adjusting our assumptions and improving our manuals. 

Feel free to mark more than one reply to a question and to make any additional comments. 

Please do not use this form for questions about technical applications of your system or re- 
quests for additional publications. Instead, direct those inquiries or requests to your nearest HP 
Sales and Service Office. 

If the comments card is missing, please address your comments to: 

HEWLETT-PACKARD COMPANY 

Desktop Computer Division 

3404 East Harmony Road 

Fort Collins, Colorado 80525 U.S.A. 

Attn. Customer Documentation 
Dept. 4231 

All comments and suggestions become the property of Hewlett-Packard. 



Comments Card for the Assembly Development ROM Manual 
Yourself 



2. Which Series 9800 Desktop Computer do you have? 

O 9835A O 9835B O 9845B 



O 9845C 



3. What was your level of programming knowledge before you started using this manual? 
O none O beginner O intermediate O expert 



The Manual 



1. Did you have any difficulty in: 

understanding material in manual? 
applying that information? 



2. How would you rate the: 



one 


minimal 


some 


considerable 


O 


O 


O 





O 


O 


O 


O 





excellent 


good 


fair 


poo 


areas covered 


O 


O 


O 


o 


depth of coverage 


O 


o 


o 


o 


examples 


o 


o 


o 


o 


indexing 


o 


o 


o 


o 


organization 





o 


o 


o 


overall manual 


o 


o 


o 


o 



What do you suggest we do to improve the areas that you consider weak? 



The Method 



1. By which method would you have preferred to learn the use of your computer? 

O Present set of manuals 

O Manuals using programmed-learning approach 

O Training workbooks with corresponding tape cartridge 

O Manuals resident in computer's memory, accessible through the keyboard and displayed on the CRT 

O Training in classroom situation at Hewlett-Packard 



General comments: 



Name: 

Address: 
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Assembly Language ROM Errors 

Improper argument for OCTAL or DECIMAL function or assembled location. 

Break Table overflow. 

Undefined BASIC label or subprogram name used in IBREAK statement. 

Attempt to write into protected memory; or, attempt to execute instruction not 
in ICOM region. 

Label used in an assembled location not found. 

Doubly-defined entry point or routine. 

Missing ICOM statement. 

Module not found. 

Errors in assembly. 

Attempt to move or delete module containing an active interrupt service 
routine. 

IDUMP specification too large. Resulting dump would be more than 32 768 
elements. 

Routine not found. 

Unsatisfied external symbols. 

Missing COM statement. 

BASIC'S common area does not correspond to assembly module require- 
ments. 

Insufficient number of items in BASIC COM declarations. 

Assembly-Time Errors 

Doubly-defined label 

END instruction missing; or module name does not match. 

Expression evaluation error. 

Literal pools full or out of range. 

ICOM region overflow. 

Operand out of range. 

Argument declaration pseudo-instruction out of sequence. 

Incorrect type of operand used. 

Undefined symbol. 
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